[mod_cluster-issues] [JBoss JIRA] Created: (MODCLUSTER-141) Use versioned docs

[Paul Ferraro (JIRA)]

Use versioned docs
------------------

                 Key: MODCLUSTER-141
                 URL: https://jira.jboss.org/jira/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/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira