From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1MuAzG-00053a-St for garchives@archives.gentoo.org; Sat, 03 Oct 2009 20:13:51 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 6243CE0ABD; Sat, 3 Oct 2009 20:13:49 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 18F56E0ABD for ; Sat, 3 Oct 2009 20:13:49 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp.gentoo.org (Postfix) with ESMTP id ADEB567931 for ; Sat, 3 Oct 2009 20:13:48 +0000 (UTC) X-Virus-Scanned: amavisd-new at gentoo.org X-Spam-Score: -3.397 X-Spam-Level: X-Spam-Status: No, score=-3.397 required=5.5 tests=[AWL=-0.798, BAYES_00=-2.599] Received: from smtp.gentoo.org ([127.0.0.1]) by localhost (smtp.gentoo.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id OJmb6Ktjf532 for ; Sat, 3 Oct 2009 20:13:42 +0000 (UTC) Received: from lo.gmane.org (lo.gmane.org [80.91.229.12]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTP id B0A2E67919 for ; Sat, 3 Oct 2009 20:13:40 +0000 (UTC) Received: from list by lo.gmane.org with local (Exim 4.50) id 1MuAz2-0001Nw-5c for gentoo-dev@gentoo.org; Sat, 03 Oct 2009 22:13:36 +0200 Received: from 64-201-202-141.regn.hsdb.sasknet.sk.ca ([64.201.202.141]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 03 Oct 2009 22:13:36 +0200 Received: from dirtyepic by 64-201-202-141.regn.hsdb.sasknet.sk.ca with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 03 Oct 2009 22:13:36 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: gentoo-dev@lists.gentoo.org From: Ryan Hill Subject: [gentoo-dev] Re: Anyone interested in maintaining the Gentoo Handbooks? Date: Sat, 3 Oct 2009 14:14:05 -0600 Message-ID: <20091003141405.40de4034@gentoo.org> References: <4AC765A7.6030301@allenjb.me.uk> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=PGP-SHA1; boundary="Sig_/Z0MEUEr+dJ9tSzn1qVtZoxI"; protocol="application/pgp-signature" X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: 64-201-202-141.regn.hsdb.sasknet.sk.ca X-Newsreader: Claws Mail 3.7.2 (GTK+ 2.16.6; x86_64-unknown-linux-gnu) Sender: news X-Archives-Salt: f0e2aecc-c9e5-48ea-89ee-82ef24520649 X-Archives-Hash: a89e72e5134a9e8ddc28b87b250ca2ec --Sig_/Z0MEUEr+dJ9tSzn1qVtZoxI Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable On Sat, 03 Oct 2009 15:54:31 +0100 AllenJB wrote: > I personally would happily donate my time to working on the docs, if > only it didn't involve a markup language nobody else uses. I suggested a > closed wiki for official documentation, but was again shot down saying > that the existing team (who seem to be doing nothing) would need to > reskill and that the server admins dislike wikis. While I don't think there's anything wrong with our official docs being whe= re they are now, I'd kill for a dev-wiki to document the thousands of things we all need to know that aren't written down anywhere. And I know the response to this is going to be "if there's something that should be documented, file a bug and get it into the dev manual/handbook". While the dev manual is a good general overview of Gentoo development, there is still a lot of stuff that isn't appropriate to document there. Having a spot for package-specific maintenance docs was brought up a couple years ago and shot down. Any documentation someone writes that doesn't fit into any particular project ends up in someone's dev-space, where it's hard to find unless you know it's there, dependent on one person to keep current, and lo= st if that person retires. I've wanted to do gcc-porting guides for the last couple releases, but I have nowhere to put them and am too slow/lazy to figure out GuideXML and put them in my dev-space, where no one would see them. We also have any number of "best practices" in Gentoo that generally can only be discovered by breaking them and getting people annoyed with you; things such as when it's okay to filter flags, how to use RESTRICT to handle upstream changing a distfile without a name change, or when it's better to not use a USE flag and just force an option. These things might be appropriate for the dev manual but would benefit much more from the kind of collaboration you get with a wiki environment. Development is a dynamic thing and requires dynamic documentation. --=20 fonts, Character is what you are in the dark. gcc-porting, wxwidgets @ gentoo EFFD 380E 047A 4B51 D2BD C64F 8AA8 8346 F9A4 0662 --Sig_/Z0MEUEr+dJ9tSzn1qVtZoxI Content-Type: application/pgp-signature; name=signature.asc Content-Disposition: attachment; filename=signature.asc -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.11 (GNU/Linux) iEYEARECAAYFAkrHsJQACgkQiqiDRvmkBmI1gwCfU8LkWhq5cuTz1tLAsN6hIzVV Ev4An1uV526EjfvL1DN0wRdOmL49ZZuP =M6mI -----END PGP SIGNATURE----- --Sig_/Z0MEUEr+dJ9tSzn1qVtZoxI--