[jbossts-issues] [JBoss JIRA] (JBTM-1955) Review ALL documentation

Mark Little (JIRA) jira-events at lists.jboss.org
Tue Oct 1 09:47:04 EDT 2013


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

Mark Little commented on JBTM-1955:
-----------------------------------

I really hope we do support heuristics in XTS or we don't comply with the standard. That's what InconsistentInternalState is for. Yes it's not ideal, but it's better than what we had in the specification initially.
                
> Review ALL documentation
> ------------------------
>
>                 Key: JBTM-1955
>                 URL: https://issues.jboss.org/browse/JBTM-1955
>             Project: JBoss Transaction Manager
>          Issue Type: Task
>      Security Level: Public(Everyone can see) 
>          Components: Documentation
>            Reporter: Paul Robinson
>            Assignee: Tom Jenkinson
>             Fix For: 5.0.0.Final
>
>
> I think we need to read through all the documentation looking for:
> 1. Out of date stuff. For example, references to file locations in AS versions prior to AS7.
> 2. Irrelevant stuff. For example: XTS documents the theory of heuristics, despite having no support for them in the current protocols or implementation.
> 3. Incorrect stuff. No examples, but there could be some errors.
> 4. Missing stuff. Most likely for new features, not yet documented.
> For 1. in particular, we should search across the entire documentation for other occurrences of the same issue, once found. For example, if a reference to bin/run.sh is found, then grep over all the other docs for other occurrences.
> I think we should divide up the docs between multiple people so as to not over-burden a single individual with what is likely to be a tedious task.

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


More information about the jbossts-issues mailing list