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

[Jean-Frederic Clere (JIRA)]

     [ https://jira.jboss.org/browse/MODCLUSTER-141?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Jean-Frederic Clere updated MODCLUSTER-141:
-------------------------------------------

    Fix Version/s: 1.1.0.Final


> 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
>             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 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