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, gentoo-doc@g.o
From: Matt Turner <mattst88@g.o>
Subject: Re: Review of Documentation Policy
Date: Mon, 15 Aug 2011 17:46:01 -0400
On Mon, Aug 15, 2011 at 5:23 PM, Sven Vermeulen <swift@g.o> wrote:
> Hi guys,
>
> Sorry to barge in like this here, but why not start a nice discussion on
> things... Keeps the minds fresh and the activity high (heh, almost sounds
> like a bad exercise DVD).
>
> The GDP currently uses the Documentation Policy [1] as its main policy on
> documentation development, recruitment, team organization and what not. It
> was written a few years ago and has seen some small changes since. However,
> like any policy, it should best be reviewed from time to time.
>
> So, what is your take on the policy? Which things need to be changed? What
> would you like to see added?
>
> Wkr,
>        Sven Vermeulen
>
> [1] http://www.gentoo.org/proj/en/gdp/doc/doc-policy.xml

The recruiting information seems strange and unnecessarily structured.
It all seems to be written for people who are not developers.

The Contributions phase mentions a lot of undefined titles,
"Operational Manager", "Full-time Developer", "Part-time Developer".
There's a table that shows the number of contributions/time for a
developer, but what do these roles actually mean? Who/what is an
"Operational Manager"?

> ... 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.

Thanks,
Matt


Replies:
Re: Review of Documentation Policy
-- Sven Vermeulen
References:
Review of Documentation Policy
-- Sven Vermeulen
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Review of Documentation Policy
Next by thread:
Re: Review of Documentation Policy
Previous by date:
Review of Documentation Policy
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.