+1 for me as well. Having the doc source with source code is a must have IMO.
Antoine Sabot-Durand Le 4 août 2014 à 17:52, Jason Porter <lightguard...@gmail.com> a écrit : Wow, looks like a lot of work was spent on the analysis of the documentation! Thanks Michelle! +1 from me for all the suggestions. On Fri, Aug 1, 2014 at 10:46 AM, Rafael Benevides <benevi...@redhat.com> wrote: > 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 > > [image: Red Hat] > > Better technology. Faster innovation. Powered by community collaboration. > See how it works at www.redhat.com > > [image: LinkedIn] <http://www.linkedin.com/company/3258288> [image: > Youtube] <https://www.youtube.com/redhatlatam> > -- Jason Porter http://en.gravatar.com/lightguardjp
