From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 706E9138216 for ; Mon, 2 May 2016 21:27:57 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 6458B21C080; Mon, 2 May 2016 21:27:46 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id AC05921C07F for ; Mon, 2 May 2016 21:27:45 +0000 (UTC) Received: from greysprite.dite (cpe-74-77-145-97.buffalo.res.rr.com [74.77.145.97]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: blueness) by smtp.gentoo.org (Postfix) with ESMTPSA id 95DFE340BCB for ; Mon, 2 May 2016 21:27:44 +0000 (UTC) Subject: Re: [gentoo-project] [RFC] New Overlays project guide To: gentoo-project@lists.gentoo.org References: <20160502232235.4741324b.mgorny@gentoo.org> From: "Anthony G. Basile" Message-ID: <5727C64D.7010706@gentoo.org> Date: Mon, 2 May 2016 17:27:41 -0400 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:38.0) Gecko/20100101 Thunderbird/38.7.2 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Project discussion list X-BeenThere: gentoo-project@lists.gentoo.org Reply-To: gentoo-project@lists.gentoo.org MIME-Version: 1.0 In-Reply-To: <20160502232235.4741324b.mgorny@gentoo.org> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Archives-Salt: d82162f6-9110-49f8-9bda-6550924f3c56 X-Archives-Hash: 7970c1eaa0f95420c707279fbb079980 On 5/2/16 5:22 PM, Michał Górny wrote: > Hello, everyone. > > The documentation of Overlays project [1,2,3] is in pretty bad shape > right now. Aside to being outdated, I find the current form not very > readable or focused. The large number of short sections makes reading > harder, and a lot of information is either useless or goes outside > the scope of project documentation. > > For this reason, I would like to replace the documentation with a new, > short guide I've written [4]. The goal would be to make it a 'how > to...' form of guide focused on Gentoo Overlays project-specific > topics. Right now it covers requesting repositories and reporting bugs > on them. Additional topics can be added if necessary. > > I would like to explicitly avoid including documentation belonging > elsewhere such as layman user guides, partial ebuild development guides > or VCS guides. > > What do you think? > > [1]:https://wiki.gentoo.org/wiki/Project:Overlays/Policy > [2]:https://wiki.gentoo.org/wiki/Project:Overlays/Dev_Guide > [3]:https://wiki.gentoo.org/wiki/Project:Overlays/User_Guide > [4]:https://wiki.gentoo.org/wiki/Project:Overlays/New_overlays_guide > I like it. -- Anthony G. Basile, Ph.D. Gentoo Linux Developer [Hardened] E-Mail : blueness@gentoo.org GnuPG FP : 1FED FAD9 D82C 52A5 3BAB DC79 9384 FA6E F52D 4BBA GnuPG ID : F52D4BBA