The Oak documentation lives as Markdown files in src/site/markdown such
that it easy to view e.g. from GitHub. Alternatively the Maven site plugin
can be used to build and deploy a web site as follows:
From the reactor use
mvn site
to build the site without Javadoc or
mvn site -Psite-with-javadoc
to build the site with Javadoc. Review the site at oak-doc/target/site.
Then deploy the site to http://jackrabbit.apache.org/oak/docs/ using
mvn site-deploy
Finally review the site at http://jackrabbit.apache.org/oak/docs/index.html.
To skip the final commit use -Dscmpublish.skipCheckin=true. You can then
review all pending changes in oak-doc/target/scmpublish-checkout and follow
up with svn commit manually.
Every committer should be able to deploy the site. No fiddling with
credentials needed since deployment is done via svn commit to
https://svn.apache.org/repos/asf/jackrabbit/site/live/oak/docs.