You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nifi.apache.org by "Matt Gilman (JIRA)" <ji...@apache.org> on 2015/04/08 13:57:12 UTC
[jira] [Commented] (NIFI-292) Replace/Update REST API documentation
generator
[ https://issues.apache.org/jira/browse/NIFI-292?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14485155#comment-14485155 ]
Matt Gilman commented on NIFI-292:
----------------------------------
It appears that the new version of swagger-core with support for swagger 2.0 specification has been released. Additionally, the maven plugin (developed by the community, not the swagger team) has also released a version compatible with the 2.0 specification.
> Replace/Update REST API documentation generator
> -----------------------------------------------
>
> Key: NIFI-292
> URL: https://issues.apache.org/jira/browse/NIFI-292
> Project: Apache NiFi
> Issue Type: Improvement
> Components: Core Framework, Core UI
> Reporter: Matt Gilman
> Assignee: Matt Gilman
>
> Currently, we use enunciate to generate our REST API documentation. As part of the generated docs, a JS library with a questionable license is included.
> Consider updating the usage to use a custom Freemarker Transform as specified here:
> http://docs.codehaus.org/display/ENUNCIATE/Applying+a+Custom+Skin+to+Enunciate%27s+Documentation
> or switching to another solution altogether.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)