Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: Matt Turner <mattst88@g.o>
Subject: Re: Review of Documentation Policy
Date: Mon, 22 Aug 2011 20:16:59 -0400
On Fri, Aug 19, 2011 at 1:22 PM, Sven Vermeulen <swift@g.o> wrote:
>> > ... to inform the contributor about the time-consuming position and pressure the application involves.
>>
>> Come on. What is this? I don't think I remember getting paid as a
>> Gentoo developer. This nonsense about time commitments and pressure is
>> pretentious.
>>
>> It seems to me that the steps for joining the Docs team for a current
>> developer should be much more clearly stated.
>
> Any suggestion here? It isn't difficult to update the policy to be more
> real-life like (my own immediate suggestion would be to drop the "numbered"
> commit / bug requirement and instead use a regular mentoring role, and
> putting the responsibility of acknowledging in the mentor's lap) but we
> might even go beyond just "updating" the policy.

The information on this page is very irrelevant and confusing to me,
as a developer.

I don't know how many non-developer documenters we have. I don't know
what needs to happen to that text itself, but a section about how
current developers join the documentation team is important. Looking
at the page, a person must complete the staff and doc quizzes. For a
developer, it seems that the requirements should simply be 1) to have
become a developer and 2) completed the doc quiz.

Thanks,
Matt


Replies:
Re: Review of Documentation Policy
-- Sven Vermeulen
References:
Review of Documentation Policy
-- Sven Vermeulen
Re: Review of Documentation Policy
-- Matt Turner
Re: Review of Documentation Policy
-- Sven Vermeulen
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: Review of Documentation Policy
Next by thread:
Re: Review of Documentation Policy
Previous by date:
Re: Use of link attribute in <guide> tag
Next by date:
Re: Review of Documentation Policy


Updated Apr 08, 2012

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.