Future documentation generation from within SAVARA is likely to revolve around docbook. Although this can be edited using any XML editor, some initial work has been done within JBossTools to support visualisation of the docbook contents in HTML during editing - https://jira.jboss.org/jira/browse/JBIDE-1304
Check out the images and see what you think - and if you think it would be useful for SAVARA, vote for it. Also may be useful if anyone is interested in submitting patches for the "quirks" - please feel free. The sooner we can get this capability into the main stream JBossTools build the better.
Alternatively, if anyone has suggestions for alternative open source docbook editors that could be used, then let us know.