On 15 October 2010 11:00, Adrian Trenaman <trena...@progress.com> wrote: > Hi Eric, > > I'd be very happy to get the stuff out of confluence and into SVN as you > propose. I saw a post from James on Scalate, and I think that it would be > great way to leverage Scalate as part of our renovation. > > Possibly the most important things for me are: > > a) That it becomes part of source-code control. This makes documentation a > 'first class citizen' in our community, and allows talented writers to > contribute and become recognized committers. In the past, there has been > little incentive or recognition for writing documentation, and this will fix > that. > > b) That whatever format we use is easy-peasy to write, and lets us focus on > content/structure rather than formatting. > > On a related note, the documentation problem on the Apache site is, I feel, > doing the ServiceMix community a disservice - yet, thankfully, its not an > NP-hard problem to fix! To fix it fast, I'd like to propose a 'docuthon' > event. If someone can set out the structure of the documentation, and then > create a load of JIRA's for the individual sections/sub-sections that need > to be written, we could mobilize the community for a single week to stop > coding and get writing, for just one week. Then, someone in an 'editor' role > can pull it all together, clean it up, and enforce coherency. > > What do you think?
Sounds like a great idea! -- James ------- http://macstrac.blogspot.com/ Open Source Integration http://fusesource.com/
