discussed at the Sling Committer Round Table @ adaptTo() 2016

sling provides a couple of maven plugins, but does not provide a detailed 
documentation about their goals and properties at [1].

such a documentation can be generated easily by using the maven site for the 
plugin project. the only question is: how should it be published and integrated 
in the maven site?

it would be sufficient to link to it from the maven site, it does not 
necessarily have to be "fully integrated" in the layout of the sling docs pages.

the documentation for the different releases of maven plugins should be 
available in parallel.

one option would be to generate the site and include it in the sling site svn. 
this is not very elegant and will bloat the site svn, and it is bad practice to 
check in generated markup, but it would work. but it is a manually step one to 
execute on each release of a maven plugin.

next step would be creating a JIRA ticket for this.

stefan

[1] http://sling.apache.org/


Reply via email to