[jboss-jira] [JBoss JIRA] (WFLY-1725) Update The Wildfly High Availability Guide

[Richard Achmatowicz (JIRA)]

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

Richard Achmatowicz edited comment on WFLY-1725 at 7/19/13 3:53 PM:
--------------------------------------------------------------------

Some other aspects:

I think adequate framing of sections is important together with well defined and ordered subsections (i.e. introduction and overview, followed by sections with more specific detail)

I also think that consistency of presentation across sections is important, as we move through 
* different subsystems
* different collections of functionality
So, for example, touch on the same classes of points in each section (e.g. new features, configuration detail, example) 

By the way, for an excellent example, I look to the ISPN docs.
                
      was (Author: rachmato):
    Some other aspects:

I think adequate framing of sections is important together with well defined and ordered subsections (i.e. introduction and overview, followed by sections with more specific detail)

I also think that consistency of presentation across sections is important, as we move through 
- different subsystems
- different collections of functionality
So, for example, touch on the same classes of points in each section (e.g. new features, configuration detail, example) 

For an excellent example, I look to the ISPN docs.
                  
> Update The Wildfly High Availability Guide 
> -------------------------------------------
>
>                 Key: WFLY-1725
>                 URL: https://issues.jboss.org/browse/WFLY-1725
>             Project: WildFly
>          Issue Type: Bug
>          Components: Clustering
>    Affects Versions: 8.0.0.Alpha3
>            Reporter: Richard Achmatowicz
>            Assignee: Richard Achmatowicz
>             Fix For: 8.0.0.Beta1
>
>
> The main source of clustering-related documentation for a Wildfly user is the High Availability Guide in the Wildfly 8 documentation on docs.jboss.org.
> Update this document into a quality document which will aid the user's understanding of new features and configuration in Wildfly 8 clustering.

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