[ https://issues.jboss.org/browse/WFLY-1725?page=com.atlassian.jira.plugin.... ] Richard Achmatowicz commented on WFLY-1725: ------------------------------------------- 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. -- 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