I ported two more pages to CMS, which I removed from Maven APT pages:
http://sis.staging.apache.org/code-patterns.html
http://sis.staging.apache.org/faq.html
I also specified explicitly the anchors in every headers of every pages.
The intend is to have more stable anchors if the SIS site is referenced
by external sites.
Do peoples agree for publishing those modifications?
At first I was considering a mix of Maven and CMS pages. But given that
CMS appears to be more flexible than APT/FML and reasonably easy once we
get familiar with it, I propose to migrate everything to CMS and remove
the corresponding documentation from the Maven site, in the hope to
simplify maintenance. The main inconvenient I can see is that some
manually generated CMS pages may lag behind the automatically generated
Maven pages (team list, mailing lists, source code repository). However
this is a minor concern if those pages do not change often. An other
slight inconvenience is that if a class is moved or deleted, we must
remember to perform a search in the web site repository in addition to
the Java code repository.
Martin
