There were 2 questions/comments:
- Can we keep semantic of docbook ?
Answer is no. The Wysiwyg and WIKI markup have smaller scope for
semantic (which isn't bad as we tend to use different semantic in
docbook for the samething such as programlisting vs code).
There is an authoring guide here that I would recommend to follow even
though, it's quite natural:
https://docs.jboss.org/author/display/AUTHGUIDE/Markup+Guide
- Cross-reference links (to sections) are broken.
Indeed there is an issue here, it works fine when it references a
chapter but not a section. I mentioned the issue but I prefer not to
wait on resolution. There are 52 links like that that are broken, I'm
still checking if I can fix them prior to the import, otherwise I will
fix some when reviewing the doc.
I won't migrate today because of the second issue, so for now, please
continue with docbook in GIT.
Thanks,
Thomas.
On 09/24/2012 04:55 PM, Thomas Heute wrote:
We are moving docs from docbook in Git to Confluence on
jboss.org.
Confluence has the option to use a WYSIWYG editor or a Wiki markup
editor, it instantly gives you something easy to read.
I migrated user guide and reference guide for check here, it seems that
it worked pretty nicely:
https://docs.jboss.org/author/display/GTNPORTAL35
I want to give a few days so that people can check that the migration
process is ok.
It there is no objection, on Friday I will take the latest from Git and
regenerate those docs and send an email here. I will also delete the
docs folder from our Git repository.
From that moment, any doc change will have to be done through:
https://docs.jboss.org/author/display/GTNPORTAL35
Thanks,
Thomas.
_______________________________________________
gatein-dev mailing list
gatein-dev(a)lists.jboss.org
https://lists.jboss.org/mailman/listinfo/gatein-dev