Gentoo Archives: gentoo-doc

From: Sven Vermeulen <swift@g.o>
To: gentoo-doc@l.g.o
Subject: Re: [gentoo-doc] Review of Documentation Policy
Date: Sat, 24 Sep 2011 06:41:48
In Reply to: Re: [gentoo-doc] Review of Documentation Policy by Joshua Saddler
On Fri, Sep 23, 2011 at 05:22:37PM -0700, Joshua Saddler wrote:
> Thanks for the draft! From a quick run-through of the patch (much > obliged for that, thanks), it seems pretty good. > > The major differences to the original doc are: > > 1. Doing away with the Strategic/Operational lead split. We haven't > had two people doing those jobs in 5 years, anyway.
Yup, most - if not all - other projects are based on a project lead and lots of minions, so this was a fairly obvious change imo.
> 2. Translation project leads and "official" language status. Any > comments as to the changes here?
Sure. I wanted to make it a bit less formal without lowering the requirements. Now, the document sais that a language should be backed up by a translation team where at least one member (the translation project lead) has commit access. If this isn't the case, then it is an "unsupported" language where the documents are still published, but not linked.
> 3. Join-up process. No formal "X number of contributions per period > Y." Works well enough for me, but then "how much does this potential > recruit actually do for us" becomes subjective hand-waving. We would > need a new metric to determine commitment over time. Ideas?
I'm not sure we need one. Imo, the GDP project lead decides when phase 2 starts (and as such when a mentor is assigned). From then onwards, it is the mentor who is in charge of defining when the recruitment can be started. If we need a more objective metric to start with, I'd rather do it on timeframe ("... sufficient document changes over a term of at least 4 months"), which holds twice then (first and second phase). After all, developers that have been less or inactive for some time are slated to be retired anyhow, either fully (from the Gentoo project) or from the GDP (removal of the GDP page and perhaps cvsdoc commit rights). Wkr, Sven Vermeulen


Subject Author
Re: [gentoo-doc] Review of Documentation Policy Joshua Saddler <nightmorph@g.o>
Re: [gentoo-doc] Review of Documentation Policy "Francisco Blas Izquierdo Riera (klondike)" <klondike@g.o>