reorganize the doc

> jerome
trygve

> Some of the issues:
>
> - the general structure (header, ...) is in the site.xml, so it has to
> be copied pasted into every plugin site.xml file
> - the list of plugins in the menu has to be manually updated

I would like to remove these two lists into two separate pages which has
a simple list of the plugins with a small description of the plugin.

> - some plugins doc today just point to subversion

For sandboxed plugins that's IMO fine, can be a pita for folks to deploy
snapshots after each commit. Might be easier now with WebDAV, or
possibly Continuum should do it.

> - the list of plugins starts to be long and requires the user to
> scroll down the main page. This also move important mojo information
> pages to the bottom, kindof unseen to the developers
> - now it appears that site generation time information only contains
> date. I preferred the full time stamp.

Isn't the date enough?

> - no plugin version number appears in the generated site. I think we
> need both.
> - less important: only the latest version of the doc is uploaded. I
> guess I am the only one to like having a history

I would like one site per version and the one in the root directory to
be the one in trunk with pointers to all the released versions.

> I was wondering if there's some work being done to try to improve the
> general look of the site. One way I could see it:
>
> Each plugin site.xml is built from a template, and the generated doc
> contains the plugin version. The list of plugins is generated
> automatically from the subprojects (or from the deployed plugin
> sites?). In both cases, those plugins wich have no doc have no entry
> in the menu. The plugin list is somehow folded, in a way that still
> allows to search using the browser search function.

The proposal is tracked on http://docs.codehaus.org/display/MOJO/Mojo+web+site+redux