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

[Michal Babacek (JIRA)]

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

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)