[documentation] reaching my full maintenance potential

[blogdiva at culturekitchen.com]

In the interest of good developing good cooperation and  
communications practices :

(1) more than two people should review queued documentation. Two  
heads work better than one.

(2) if the documentation is so-so, both will annotate and send it  
back with comments to the author, giving the author the option of
--changing the documentation themselves OR
--publishing it as a forum topic with a request for review by the  
community

(3) a notification alert should go out to all authors whose work has  
been published in the documentation section of drupal.org. Actually,   
I believe the same should be an option for all forum discussions.  
With comments alerts (notification module, btw)  going immediately to  
the author, hopefully Drupal.org will be ensuring quick response to  
issues and/or maintenance of the site.

Best,
liza sabater



On  03.Sep.2006, at 12:51 PM, Greg Knaddison - GVS wrote:

> On 9/3/06, sime <info at urbits.com> wrote:
>> I keep going to do some maintenance of drupal.org and then losing my
>> mojo. I get confused. I have some questions. If any of these are
>> misdirected or are answered readily in the handbook, I don't mind
>> hearing that and I'll go find them.
>
> I don't know that all are answered there, but I recently found a Site
> Maintainer's Guide, which is quite useful:
> http://drupal.org/node/21923
>
>
> <snipped issues already covered in that guide>
>
>> 2) If something is in the moderation queue, and I think it needs more
>> work, do I just say so in the notes and then leave it? Do I notify  
>> the
>> author?
>
> I'd say publish it and leave a comment requesting more work.  Docs are
> always in flux and could always be better in some way.  It's a shame
> to leave them unpublished (unless the author really meant to hide
> them, but if so, use a text file on your machine as the drafting place
> and don't use the drupal.org queue for drafting).
>
>> 3) If a document in the moderation queue *really sucks*, is it  
>> assumed
>> that I will make a value-judgement and remove it?
>
> Not sure.
>
>
>> Finally
>> 4) Am I being too precious and I should just get going....? That  
>> is, as
>> long as my intentions are good, eventually I will get pulled up for
>> making the wrong decision.
>
> Well, you can be sure that if you delete something that the author
> really liked then you'll hear a scream from them ;)
>
> Greg
>
> -- 
> Greg Knaddison | Growing Venture Solutions
> Denver, CO | http://growingventuresolutions.com
> Technology Solutions for Communities, Individuals, and Small  
> Businesses
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>