[jbossts-issues] [JBoss JIRA] (JBTM-1116) Document properties

[Tom Jenkinson (JIRA)]

    [ https://issues.jboss.org/browse/JBTM-1116?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12739195#comment-12739195 ] 

Tom Jenkinson commented on JBTM-1116:
-------------------------------------

Good points, lets rework this Jira as an opportunity to simply:
1. Ensure the Javadocs in isolation are still correct, fully explained
2. Ensure the documentation explains the architecture of our configuration mechanism
3. Ensure the documentation builds on point 2 to reference the relevant beans when configuring common deployment scenarios, e.g. which properties do you need to enable hornetq/JDBC object store


                
> Document properties
> -------------------
>
>                 Key: JBTM-1116
>                 URL: https://issues.jboss.org/browse/JBTM-1116
>             Project: JBoss Transaction Manager
>          Issue Type: Feature Request
>      Security Level: Public(Everyone can see) 
>          Components: Documentation
>            Reporter: Tom Jenkinson
>            Assignee: Gytis Trikleris
>             Fix For: 5.0.0.M3
>
>
> In the pre-Bean days of setting properties, we had all of the TS properties called out in a properties.xml file. In that file there were copious comments to say what the property was for and whether it should be changed. We also documented these properties in the docs. It seems from some investigation that Mike and I have done today that the migration away from the properties file to using MBeans has removed those comments and the docs for the properties. Sometimes the comments do appear in the code.
> If you go back to before everything got turned everything into a Bean (probably 4.6.1 GA) then look in the etc directories.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira