[snip] > Many of us - 'documentors' - (if not all) are programmers and used to use > CVS and other versioning system. But this takes some extra time that IMHO it > shouldn't. If you want to "spread the word" and get lots of people to help > in docs, I believe this kind of thing that Launchpad uses is a go. I'm very > well aware that this takes time and not every contributor may actually help > with good docs, but it could be moderated.
[snip] 100% yes - the initial hurtle to getting new people writing docs is teaching them docbook and cvs. You can whine all you want about "how easy it is" - but it is NOT a zero learning curve and there are no good (free) docbook tools on the systems most people use on the desktop (yes, I mean Windows - and no people are not going to switch OS's for docbook tools). Writing in XML is not a natural thing. An online interface where people can edit docs would seriously boost people helping out. Why do you think there are so many user notes in the PHP manual ;) However...you will have to wade through the bad docs too. And I have no solution for dealing with the "three million tools" issues. Thanks, Elizabeth Smith -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
