<br><br><div><span class="gmail_quote">On 8/8/07, <b class="gmail_sendername">Steven Peck</b> <<a href="mailto:sepeck@gmail.com">sepeck@gmail.com</a>> wrote:</span><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
The handbooks are a wiki for people with appropriate rights. There<br>are 98 of these people currently. <a href="http://drupal.org/node/109372">http://drupal.org/node/109372</a><br><br>current from: <a href="http://drupal.org/handbook/new-contributions">
http://drupal.org/handbook/new-contributions</a><br>"In the past week, a total of 25 handbook pages were created. Of<br>those, 18 were spam. Of the 7 added, 5 were created by people not on<br>the documentation team:"
<br><br>Before moderation was taken out, I did in fact open the handbook up to<br>editing to a wider role. The moderation behavior was very annoying<br>but the simple fact is page vandalism was worse then the above<br>statistic.
</blockquote><div><br>I don't see captcha on D.O. but I do see it on <a href="http://groups.drupal.org">groups.drupal.org</a>. Perhaps good captcha could reduce the effort. I applaud you for trying to make an improvement.
<br></div><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">I am not resistant to the idea of 'trusting the people', I have<br>experienced the reality of wide open edit access and the vandalism it
<br>resulted in and frankly have no desire to repeat it. It was a huge<br>time sink.</blockquote><div><br>Can you define the wider role, all authenticated users?<br> </div><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
If companies are spending millions of dollars, then they can pay some<br>coders who understand FAPI to help with those documentation updates.<br>Frankly very few understand FAPI enough to write it clearly and most<br>of those do so from a developer point of view. I certainly don't.
</blockquote><div><br>Well they are spending millions and it's not happening. I funded the original FAPI docs to support the biggest user experience problem with Drupal, upgrading. With 50 comments or more, it's clear that the community has risen to the challenge of improving these docs. But it's the implementation that is preventing this success.
<br> </div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">Versioning. Versioning is hard. Not the least because it can involve<br>duplication of content but because one persons contribution are often
<br>not something that everyone has the interest in updating. I don't<br>have access to cPanel nor am I interested in cPanel setup docs, but<br>someone contributed it for (say version 4.7). So hopefully someone<br>who is interested will update it... The volume of pages in the
<br>handbook is staggering.</blockquote><div><br>Good ;-)<br> </div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">I'll have a seperate post on a path that I am pursuing.
</blockquote><div><br>Looking forward to it.<br><br>Kieran<br> </div><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">-sp<br><br><br>On 8/8/07, Laura Scott <
<a href="mailto:laura@pingv.com">laura@pingv.com</a>> wrote:<br>><br>> On Aug 8, 2007, at 11:33 AM, Kieran Lal wrote:<br>> I think all the documentation should be a wiki. Click here to edit. Give<br>> admins the ability to lock pages, were necessary.
<br>><br>> The current status of having 50 comments on a page for something as critical<br>> how to upgrade your module to the next API version, is completely<br>> unacceptable. We are forcing companies and admins to spend collectively
<br>> millions of dollars on upgrading their sites between versions with<br>> inconsistent and unclear documentation.<br>><br>> Agree on this 100%.<br>><br>> Something sepeck and I discussed at OSCMS was that all the versions are
<br>> intermingled, and that ideally we would have handbook views by version<br>> number, and done in a way that avoids massive node duplication in order to<br>> effect hierarchy.<br>><br>> The handbooks are a particularly tough challenge. Wonder if what we really
<br>> need are tabbed views for each page, with each tab offering potentially<br>> version-specific info. Even in a wiki, that approach might be helpful from a<br>> usability standpoint. The tagging alone gets us part of the way there.
<br>><br>> Laura<br>><br>><br>> --<br>> Pending work:<br>> <a href="http://drupal.org/project/issues/documentation/">http://drupal.org/project/issues/documentation/</a><br>> List archives:<br>>
<a href="http://lists.drupal.org/pipermail/documentation/">http://lists.drupal.org/pipermail/documentation/</a><br>><br>--<br>Pending work: <a href="http://drupal.org/project/issues/documentation/">http://drupal.org/project/issues/documentation/
</a><br>List archives: <a href="http://lists.drupal.org/pipermail/documentation/">http://lists.drupal.org/pipermail/documentation/</a><br></blockquote></div><br><br clear="all"><br>-- <br>To strive, to seek, to find, and not to yield.
<br>