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 ) 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 ; Thu, 29 Nov 2007 13:57:37 GMT Received: by nf-out-0910.google.com with SMTP id f5so1748993nfh for ; 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" Sender: cooldwind@gmail.com To: gentoo-dev@lists.gentoo.org Subject: Re: [gentoo-dev] [RFC] Features and documentation In-Reply-To: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail 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> <20071128211553.GB11126@supernova> 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 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