We've done these in the past and they have been very successful and very not. :D They key is that they be coordinated and very clear in their intention and structure. <br><br>People who write really awesome articles on WordPress want to "own" the content. They also tend to want credit and links back to themselves to further their reputation and often get paid jobs as a WordPress expert. Finding a way to make this process work without the "I" and credit and make it a team effort is the challenge. <br>
<br>The most successful approach has been when we work on the documents together as a team across a one to two month "swarm" time ( <a href="http://www.scottporad.com/2009/06/24/want-to-get-more-done-heres-how-do-less/">http://www.scottporad.com/2009/06/24/want-to-get-more-done-heres-how-do-less/</a> ) it is very successful as one comes up with an idea, writes it up in a specific section off the table of contents, people add to it, edit it, and develop the idea further though conversations in the IRC for docs. When it's ready, it's moved into the final spot on the Codex and added to the TOC. It's very intense and really works well.<br>
<br>Call to actions for people to submit their documents like a competition or just encouraged to do so have been very unsuccessful. It's the stimulation that comes from working with like minds that seems to encourage participation rather than "here's my article" and the docs team having to edit the "I" out of it. Boring work for all involved. <br>
<br>I'd love to take the energy from the WordPress 3.0 release to get the docs team rocking. So that's a look at the past. What can we do now?<br><br>Lorelle<br>
<br><br><div class="gmail_quote">On Mon, Jun 7, 2010 at 6:51 AM, John Blackbourn <span dir="ltr"><span><johnbillion+wp@<a href="http://gmail.com">gmail.com</a>></span></span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
Mark Jaquith mentioned that 'We're even considering "taking a release<br><span>
off" to work on <a href="http://WordPress.org">WordPress.org</a>'. [1]</span><br>
<br>
If this is the case, maybe as part of this it would be a good idea to<br>
co-ordinate a documentation improvement drive. Kind of like a bug hunt<br>
but a not-very-good-documentation-hunt instead. In fact it could take<br>
just the same format as a bug hunt, but rather than going through<br>
tickets, volunteers would go through Codex articles and update or<br>
improve them as necessary. We could even identify areas that need new<br>
Codex articles writing and do that at the same time.<br>
<br>
I've also noticed [2] that the Info Page for each of the mailing lists<br>
are completely void of information (probably one of the main reason<br>
wp-hackers gets its steady stream of threads that don't really belong<br>
there). I don't know if Mailman allows for these pages to be<br>
customised, but they could be used to provide a big pile of<br>
information about exactly what the mailing list is and where best to<br>
get support in cases where the mailing list isn't appropriate.<br>
Information to go on these pages could be written as part of the<br>
documentation drive.<br>
<br>
Does this sound like a good idea? I think many members of the<br>
community would be willing to help out as we all know the docs need<br>
improving but I know personally that the motivation to do it is low (I<br>
do try!). A co-ordinated effort by the commnunity would give a big<br>
lift to all those involved.<br>
<br>
John<br>
<br>
[1] <a href="http://lists.automattic.com/pipermail/wp-hackers/2010-June/032370.html" target="_blank">http://lists.automattic.com/pipermail/wp-hackers/2010-June/032370.html</a><br>
[2] <a href="http://lists.automattic.com/pipermail/wp-hackers/2010-June/032372.html" target="_blank">http://lists.automattic.com/pipermail/wp-hackers/2010-June/032372.html</a><br>
_______________________________________________<br>
wp-docs mailing list<br>
<a href="mailto:wp-docs@lists.automattic.com">wp-docs@lists.automattic.com</a><br>
<a href="http://lists.automattic.com/mailman/listinfo/wp-docs" target="_blank">http://lists.automattic.com/mailman/listinfo/wp-docs</a><br>
</blockquote></div><br>