Asciidoctor can be found here .
Some reasons for doing this:
- the source code for the website will be in git (rather than svn as currently), and so will be mirrored to github. Therefore users/contributors can fork our repo and submit pull requests on the docs/website.
- the generated content can be previewed locally; ASF's svnpubsub infrastructure is used only for publishing/hosting the site
- there are also some doubts about svnpubsub's long-term future, so we should minimize our dependence on it if possible
- the toolchain seems to exist already and is in use by at least one other ASF project - Deltaspike  - who have got the toolchain to work. (Wicket are also experimenting, )
- the generated pages are themeable either using Foundation (the default) or using Bootstrap .
- github natively understands asciidoc (.adoc) files, and are enthusiastic supporters (see this article of Scott Chacon, )
- there are editors for Asciidoctor, eg 
- longer term, it's possible that the docs could be converted into a book, eg using O'Reilly's Atlas platform 
Good starting points:
- the DeltaSpike pom.xml's. They seem to have two separate regions; the top-level site [7a,7b], and a "documentation" subfolder [8a,8b]
- these use the asciidoctor-maven-plugin  to convert the .adoc files to .html
- these use the maven-scm-publish-plugin  to update the SVN (do all necessary add/deletes to properly synchronize)
- there are also some useful templates (integrated with mvn site) at 
- theming with Bootstrap might be done using any of  or [13a, 13b] (latter is asciidoc not asciidoctor so might require some fiddling around with).