[
https://issues.jboss.org/browse/MODCLUSTER-141?page=com.atlassian.jira.pl...
]
Michal Babacek closed MODCLUSTER-141.
-------------------------------------
Closing. Clean-up.
At least one of the following applies:
* the issue has been thoroughly tested as a part of one of the current releases
or
* it hasn't occurred in ~2 years
or
* it's utterly harmless
Use versioned docs
------------------
Key: MODCLUSTER-141
URL:
https://issues.jboss.org/browse/MODCLUSTER-141
Project: mod_cluster
Issue Type: Task
Security Level: Public(Everyone can see)
Affects Versions: 1.1.0.CR1
Reporter: Paul Ferraro
Assignee: Jean-Frederic Clere
Priority: Minor
Fix For: 1.1.0.Final
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 was sent by Atlassian JIRA
(v6.2.6#6264)