On Apr 4, 2013, at 10:53 AM, Radhika Puthiyetath <radhika.puthiyet...@citrix.com> wrote:
> My two cents > > We should go to conferences specifically meant for writers, and market > CloudStack. That way, we could attract good freelancers. > > The other way is to reach out to students and offer internship to those who > are interested in writing. ..In the due course, both parties are mutually > benefited: Students get good industry exposure on cutting edge technology, > whereas we might get good writers to work on CloudStack docs.. > > -Radhika > > -----Original Message----- > From: Chip Childers [mailto:chip.child...@sungard.com] > Sent: Thursday, April 04, 2013 7:37 PM > To: dev@cloudstack.apache.org > Subject: Re: [DOCS] More OSS writers needed > > On Wed, Apr 03, 2013 at 07:31:19PM -0700, Jessica Tomechak wrote: >> In this morning's IRC chat, it was very properly pointed out that >> CloudStack could use more doc writers. >> >> We have a backlog of suggestions for large, new documentation >> projects. We collected these suggestions under the Doc Writers wiki >> page. I have just opened Jira tickets for each of the items, to make >> them more visible and easier to grab for whatever new OSS writers are >> interested! >> >> Please feel free to add more items, or vote up/down on any of the >> suggested new documents, or assign a ticket to yourself and write. >> >> https://cwiki.apache.org/confluence/display/CLOUDSTACK/Documentation+S >> uggestion+Box >> >> Cheers, >> Jessica T. > > This is great... but do you (others) have any ideas about how we can attract > new tech writers to the project? I think that we obviously have > *lots* of work to do, which frankly can even go into helping to curate the > wiki, etc... My personal concern is getting enough volunteers to work on all > of this! If I were a dictator I would force every new feature to land in the source code *with* documentation. No documentation, no commit. Of course folks would hate me for it :) and the project might die. However I read that Django tries to do this. CloudStack is a complex software and the best people to write the docs are really the folks who write the features. In addition, lots of features require advanced setup that a lot of tech writers won't have at their disposal. Maybe couple days before the next CloudStack conference we can have a face to face WriteaThon... -Sebastien