As talked with Gerhard.
The reasons to use asciidoc are because it's easily exportable to PDF,
HTML, and it's also easy to contribute. It can be used to export also to
epub and It can be used to write books...
Em 8/1/14, 13:46, Rafael Benevides escreveu:
Hi all,
As you may known, Red Hat docs team was called to help on DeltaSpike
docs. After a long period, they have analyzed the documentation and
bring us an awesome plan that is available here:
https://docs.google.com/document/d/186f_amQ9XuREq8FcO7orxvOjQZtvEEYa7WPj1e8p8bM/edit#heading=h.4sqhyz68wgg2
The document is opened for comments.
Something that was also discussed not only inside Red Hat but with
some community members is about the format and source of the
documentation. I strongly believe that we should have the
documentation somewhere else but the DS site source. It could improve
the ease to the community to contribute with it. Having said that,
it's also suggested that we should use asciidoc as documentation format.
So what we have until now ?
- The documentation plan to be reviewed and approved by the DS
community. Then we can talk about the plans to make it happen.
- The documentation location: Recommendation to be out of the site source.
- The documentation format: Suggested to use asciidoc.
Please, read the plan and lets discuss about these 3 topics individually.
Michelle Murray (whose team provided the plan and she is copied on
this Thread) can follow the feedback.
--
*Rafael Benevides | Senior Software Engineer*
JBoss Developer
M: +55-61-9269-6576
Red Hat
Better technology. Faster innovation. Powered by community collaboration.
See how it works at www.redhat.com <http://www.redhat.com/>
LinkedIn <http://www.linkedin.com/company/3258288> Youtube
<https://www.youtube.com/redhatlatam>