David Jencks wrote:
I keep having some minor annoyances starting from http://geronimo.apache.org/documentation.html and hope someone who knows where that page comes from and more about how some of the rest of the site is set up can fix them.
http://geronimo.apache.org/documentation.html is basically updated manually. Given the Geronimo main web site resides on a different server from where we serve the wiki, and a limitation in the auto export plugin, we cannot generate this page automatically. http://geronimo.apache.org/documentation.html (main site) and http://cwiki.apache.org/geronimo (wiki home page) are not meant to be the same. Most of the updates on http://geronimo.apache.org/documentation.html occur around new releases time frame and it's done by committers. The wiki on the other hand is updated daily and by any contributor. The documentation home page http://cwiki.apache.org/geronimo (wiki) builds up mostly automatically from the content on the other confluence spaces such as GMOxPMGT for the Project Management. This is the markup that does that: h3. Project management *[*Apache Geronimo Project Management*|GMOxPMGT:Documentation]* {children:page=GMOxPMGT:Documentation|all=true} But again, this won't work from the main web site (http://geronimo.apache.org)
1. I'd really like a direct link from the documentation front page to the project management wiki. I can't remember how to get to the release process docs from the front page.
If you start your search from the documentation home page http://cwiki.apache.org/geronimo (wiki) there already is a direct link there to all the topics in the Apache Geronimo Project Management space (GMOxPMGT) Having said this, we can still add a link to the Geronimo release process page from the web site directly to the wiki. I think the best place to add this link would be in the "Overview" menu box.
2. The views of what is in the project management wiki seem to be inconsistent. http://cwiki.apache.org/geronimo/ has a page where the pm wiki contents have the release process doc listed last.
the macro we use for generating this lists automatically only allow alphabetical order (asc or desc). The only way to address this issue is to manually build the table of contents but we may have problems trying to keep them up to date.
http://cwiki.apache.org/GMOxPMGT/documentation.html does too
http://cwiki.apache.org/geronimo/ is based on the content listed on http://cwiki.apache.org/GMOxPMGT/documentation.html so these two should be the same.
http://cwiki.apache.org/GMOxPMGT/apache-geronimo-development-process.html has a really different organization.
The TOC on this page is not generated automatically. Actually I haven't looked at this page in quite some time so maybe I should update it to generate the TOC automatically just like to other sections. Either way I think there is a lot of info on this space that could use some "housekeeping".
I don't know if its possible but it sort of looks to me as if some of these pages are generated more automatically than others and perhaps relying always on the automatically generated views could reduce the amount of inconsistency.
One last thing on the autoexport plugin, not necessarily an issue but it still a PITA. The autoexport plugin can not realize that the automatically generated TOC on space "A" has changed so it updates another depending TOC on space "B". So I manually run auto exports on the Geronimo spaces to make sure these changes (e g in the TOC) get reflected all across GMOx sapes. Last time I checked there was no way to schedule a job to do this automatically. HTH to clarify a little bit how this "monster" work. ;-) Cheers! Hernan
thanks david jencks
