This is awesome, publish it! No worries about minor potential issues, this is still a huge improvement!
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Chris Mattmann, Ph.D. Senior Computer Scientist NASA Jet Propulsion Laboratory Pasadena, CA 91109 USA Office: 171-266B, Mailstop: 171-246 Email: [email protected] WWW: http://sunset.usc.edu/~mattmann/ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Adjunct Assistant Professor, Computer Science Department University of Southern California, Los Angeles, CA 90089 USA ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ -----Original Message----- From: Martin Desruisseaux <[email protected]> Organization: Geomatys Reply-To: "[email protected]" <[email protected]> Date: Thursday, July 25, 2013 6:49 AM To: "[email protected]" <[email protected]> Subject: Re: Large web site update in staging area >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 >
