[
https://jira.jboss.org/browse/MODCLUSTER-141?page=com.atlassian.jira.plug...
]
Jean-Frederic Clere commented on MODCLUSTER-141:
------------------------------------------------
So we keep just the index page in magnolia and move the whole stuff to a xdocs directory.
Use versioned docs
------------------
Key: MODCLUSTER-141
URL:
https://jira.jboss.org/browse/MODCLUSTER-141
Project: mod_cluster
Issue Type: Task
Affects Versions: 1.1.0.CR1
Reporter: Paul Ferraro
Assignee: Jean-Frederic Clere
Priority: Minor
Trying to maintain one copy of the documentation for multiple versions simultaneously is
proving to be a pain in the @ss...
Magnolia is very cumbersome as a documentation tool because of its treatment of
"paragraphs", especially with respect to code fragments (of which our docs have
many).
I recommend we keep all of the documentation in subversion (using doxia, docbook or
similar) so that it is versioned along with the source code. The download page would
contain links to the docs along side binary and source distributions. This seems to be
how most
jboss.org projects are setup.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
https://jira.jboss.org/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira