[documentation] Contributors to docs need more public recognition

Joshua Brauer joshua at brauerranch.com
Mon May 26 06:03:05 UTC 2008


I fear this breaks down all too quickly with a community written  
document and site. Who should get more credit the person who first  
posted the page, the person who edited it to correct the major error  
and make it actually usable, the one who added the examples that  
really bring people to the page, the person who edits the document to  
conform to the documentation standards, the person who edits the  
punctuation to make it more readable or the person who edits the run- 
on sentences from pages? :)

In all seriousness it is very hard to really accurately describe who  
did the "heavy lifting" on many pages, especially those that get a lot  
of love.

And while I'm a bit further down the list than Angie or Nancy I'd also  
say I don't want to be listed on the top, bottom or side of any page  
and while I likely would have relished this when I was starting out it  
simply would generate way too much traffic from folks who I can't  
possibly respond to and would in the long run perpetuate a feeling  
that the Drupal community are a bunch of unresponsive folks. Further I  
fear that even with the ability to turn the attribution off for my  
account that the number of people editing documents and posting things  
to see their names appear on many pages would make the signal to noise  
ratio in the documents such that I would have far less time to spend  
working in the community. I'm quite happy with the ability of anybody  
who makes a small effort to view my contributions.

Josh

On May 25, 2008, at 11:34 PM, Steve Dondley wrote:

> This would be another step in the right direction. Even just a simple
> link to this page on every documentation page that said:
>
> "This page was written by one of these fine volunteers...you can
> help!" with a link to this contributor's page. And then you could put
> a link to the revisions page so even anonymous users could see who
> contributed. It should state clearly: "See who contributed to this
> page".
>
> On Mon, May 26, 2008 at 1:26 AM, Peter Wolanin <pwolanin at gmail.com>  
> wrote:
>> Once D6 hits drupal.org, this page will be more infromative (due to
>> book module fix), and perhaps can be given higher exposure:
>> http://drupal.org/node/14205
>>
>> -Peter
>> --
>> Pending work: http://drupal.org/project/issues/documentation/
>> List archives: http://lists.drupal.org/pipermail/documentation/
>>
>
>
>
> -- 
> Prometheus Labor Communications, Inc.
> http://prometheuslabor.com
> 413-572-1300
>
> Communicate or Die: American Labor Unions and the Internet
> http://communicateordie.com
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 2427 bytes
Desc: not available
Url : http://lists.drupal.org/pipermail/documentation/attachments/20080526/4c61914d/attachment-0001.bin 


More information about the documentation mailing list