[documentation] Contributors to docs need more public recognition

[Fernando P. García]

Hello,

Just to bring my 1 cent on it, I agree with Angie(webchick), credit is for
"Drupal community", consider also that users can list what they contributed
in their d.o profile ("I contributed Drupal Documentation"), and there is a
textarea which could be used to fill a list of i.e: "Documentation I worked
on".

Blessings!

On Sun, May 25, 2008 at 11:33 PM, Angela Byron <drupal-docs at webchick.net>
wrote:

> Angela Byron wrote:
> > Steve Dondley wrote:
> >> Great point.
> >>
> >> Which sparks an idea: Why not give document pages  ownership like we
> >> do projects? Why should documentation get what amounts to 2nd class
> >> karma status? Might be a more comprehensive change but it could also
> >> be very worthwhile.
>
> As if I didn't type enough in my previous reply...  ;)
>
> I also don't buy this "2nd class karma status" bit at all. I see
> handbook contribution on exactly the same level as core patch contribution.
>
>  From index.php:
>
> ---
>
> $return = menu_execute_active_handler();
>
> ---
>
> That's the single line that makes Drupal do anything. Do you know who
> wrote that line of code? Probably not. Does it really matter? No. What
> matters is that Drupal is a kick-ass piece of software.
>
> Similarly, our goal as docs team members should be to make the handbook
> a kick-ass piece of documentation. It doesn't matter who started a page,
> or who spent the most time on it, or who fixed the most typos. Improving
> the handbook has direct benefits for /everyone/ involved in the Drupal
> ecosphere.
>
> Btw, it turns out, the person who wrote that line of code is chx
> (actually, it was originally written long before, and chx was the last
> person to refactor it, but nonetheless...). I couldn't begin to list the
> lines of code in Drupal that belong to chx, or that chx has touched. I
> don't think even chx could do that. :)
>
> But yet, somehow everyone knows that chx contributes an enormous amount
> of code to Drupal core. And somehow chx comes across as someone
> knowledgeable about Drupal. And when chx says something, people listen.
> It's because of his *actions*, not because of the *credit* given to
> those actions. The credit for core commits is actually /harder/ to
> determine than those for handbook pages; there's no nice revisions page
> showing you a list; you have to go sifting through cvs annotate and cvs
> log to figure out this kind of stuff.
>
> But by all means, add "Contributed 10-Step Form API tutorial" to your
> Drupal resumé (just as I'm sure chx has "Re-wrote the Drupal menu
> system" on his, and I have "Wrote the Form API Reference" on mine).
> There's nothing wrong with being proud of the work you've done, and
> communicating to clients and business partners that you're committed to
> improving Drupal's documentation.
>
> -Angie
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>



-- 
Fernando P. García, http://www.develcuy.com
Developer - Analista de Sistemas
+51 1 9 8991 7871, Mz. P Lt. 30 1et Urb. Pachacamac - VES, Lima - Perú
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20080525/5b21647b/attachment.htm