Gentoo Archives: gentoo-project

From: "Michał Górny" <mgorny@g.o>
To: gentoo-project@l.g.o
Cc: overlays@g.o
Subject: [gentoo-project] [RFC] New Overlays project guide
Date: Mon, 02 May 2016 21:22:54
Message-Id: 20160502232235.4741324b.mgorny@gentoo.org
1 Hello, everyone.
2
3 The documentation of Overlays project [1,2,3] is in pretty bad shape
4 right now. Aside to being outdated, I find the current form not very
5 readable or focused. The large number of short sections makes reading
6 harder, and a lot of information is either useless or goes outside
7 the scope of project documentation.
8
9 For this reason, I would like to replace the documentation with a new,
10 short guide I've written [4]. The goal would be to make it a 'how
11 to...' form of guide focused on Gentoo Overlays project-specific
12 topics. Right now it covers requesting repositories and reporting bugs
13 on them. Additional topics can be added if necessary.
14
15 I would like to explicitly avoid including documentation belonging
16 elsewhere such as layman user guides, partial ebuild development guides
17 or VCS guides.
18
19 What do you think?
20
21 [1]:https://wiki.gentoo.org/wiki/Project:Overlays/Policy
22 [2]:https://wiki.gentoo.org/wiki/Project:Overlays/Dev_Guide
23 [3]:https://wiki.gentoo.org/wiki/Project:Overlays/User_Guide
24 [4]:https://wiki.gentoo.org/wiki/Project:Overlays/New_overlays_guide
25
26 --
27 Best regards,
28 Michał Górny
29 <http://dev.gentoo.org/~mgorny/>

Replies

Subject Author
Re: [gentoo-project] [RFC] New Overlays project guide "Anthony G. Basile" <blueness@g.o>
Re: [gentoo-project] [RFC] New Overlays project guide Daniel Campbell <zlg@g.o>