From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from lists.gentoo.org ([140.105.134.102] helo=robin.gentoo.org)
	by finch.gentoo.org with esmtp (Exim 4.60)
	(envelope-from <gentoo-dev+bounces-27804-garchives=archives.gentoo.org@gentoo.org>)
	id 1Ixjyr-0000ku-3B
	for garchives@archives.gentoo.org; Thu, 29 Nov 2007 14:03:05 +0000
Received: from robin.gentoo.org (localhost [127.0.0.1])
	by robin.gentoo.org (8.14.2/8.14.0) with SMTP id lATE1DcG010175;
	Thu, 29 Nov 2007 14:01:13 GMT
Received: from nf-out-0910.google.com (nf-out-0910.google.com [64.233.182.187])
	by robin.gentoo.org (8.14.2/8.14.0) with ESMTP id lATDvbFB002661
	for <gentoo-dev@lists.gentoo.org>; Thu, 29 Nov 2007 13:57:37 GMT
Received: by nf-out-0910.google.com with SMTP id f5so1748993nfh
        for <gentoo-dev@lists.gentoo.org>; Thu, 29 Nov 2007 05:57:37 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:received:received:message-id:date:from:sender:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth;
        bh=ezsGVLyRNfmbuLYpXGT1m5rp/JWsnpYcIN6nwT1P8ZM=;
        b=kCQDoW2tGOA+Byx0x9KIlsFMaCNaSiHxDUqfj1bPbqV4IL9BIvgk/v85cwkTT/Q3YYJdaelUYVsCi8QpkJp9cZD51zUrGCthwEv6hkOKNMrGQ2zvl6c9ec8NCqfsHnWvKs46qnQ2OBEAWKuwgwKAtkeNrcSUP/eSsFW9Gownb2Y=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=received:message-id:date:from:sender:to:subject:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth;
        b=qi+UHtLfJqK8w61rnHyG4Qe9XzCiq+1LWTU5XziClL6wLlnE+02yogfIaj4SyG/e80NiUYXTVDsxRrLGFj9vbxBA7E1jyp3Zj7jOHrlRG2KgpwksPkwULjGlyE2x973XNoQiwBtb0QvhQkWgqqTITUyc/deGd1I36jQbOWhC/6o=
Received: by 10.78.165.16 with SMTP id n16mr6911832hue.1196344656526;
        Thu, 29 Nov 2007 05:57:36 -0800 (PST)
Received: by 10.78.177.11 with HTTP; Thu, 29 Nov 2007 05:57:36 -0800 (PST)
Message-ID: <3c32af40711290557u1454c06dy1a61b092bcf69474@mail.gmail.com>
Date: Thu, 29 Nov 2007 14:57:36 +0100
From: "Santiago M. Mola" <coldwind@gentoo.org>
Sender: cooldwind@gmail.com
To: gentoo-dev@lists.gentoo.org
Subject: Re: [gentoo-dev] [RFC] Features and documentation
In-Reply-To: <b41005390711281643w4e579e59j55cc0c74358b72fe@mail.gmail.com>
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <20071127192144.GP4368@supernova>
	 <b41005390711271910n74d15a96w16681f40294a5fa@mail.gmail.com>
	 <20071128211553.GB11126@supernova>
	 <b41005390711281643w4e579e59j55cc0c74358b72fe@mail.gmail.com>
X-Google-Sender-Auth: b045282a813b8a6c
X-Archives-Salt: 47ff49ef-43ab-45a3-b270-12bc04cb7a6f
X-Archives-Hash: 5375df13f0d5f4f08ec791f92ea86d98

On Nov 29, 2007 1:43 AM, Alec Warner <antarus@gentoo.org> wrote:
>
> Forcing people to write documentation won't get it written, people
> will continue to act like we just saw and either the rule will get
> ignored, or someone will change the rule, or people will leave because
> the rule is enforced aggressively and it has ruined the ability to
> contribute to the project.
>
> This is why I offered to write the GLEP for Diego and Cardoe, because
> I know they are not interested in writing it themselves.  Thats why we
> have a doc-team that for some sick reason enjoy writing and
> maintaining documentation.
>

It would be reasonable to require devs to:
a) Document changes before commiting when it's possible.
b) When a) is not applicable, ask doc project to document it before commiting.
c) When neither a) or b) are possible, file a bug asking for doc
update for the commited changes.

-- 
Santiago M. Mola
Jabber ID: cooldwind@gmail.com
-- 
gentoo-dev@gentoo.org mailing list