On 1.4.15 1:54 , Tobias Bocanegra wrote:
Hi, are there any intentions to "improve" the jackrabbit site generation?
Intentions not, wishes yes...
I would be willing to spend some time convert this to the markdown
That would be much appreciated. I think most of us quite like that approach as the documentation is close to the sources and it is easy for developers to contribute.
An additional plus for Markdown is that the documentation is also browsable on Github. Not all links work there though and if you want to have the images rendered you need to put them next to the .md files instead of into the resources folder.
Also the setup needs some Maven trickeries [1] to make the resource, site and scm-publish plugins work together in slightly non conventional ways.
If you also want to integrate the generated Javadoc there is some more bumps ahead. Basically I couldn't figure out how to make it work with a single 'mvn clean site' as currently you always need to do 'mvn clean' followed by 'mvn site' [2].
Michael [1] https://github.com/apache/jackrabbit-oak/blob/trunk/oak-doc/pom.xml [2] https://github.com/apache/jackrabbit-oak/blob/trunk/oak-doc/README.md
