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/> |
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> |