public inbox for gentoo-project@lists.gentoo.org
 help / color / mirror / Atom feed
Search results ordered by [date|relevance]  view[summary|nested|Atom feed]
thread overview below | download: 
* [gentoo-project] [RFC] New Overlays project guide
@ 2016-05-02 21:22 99% Michał Górny
  0 siblings, 0 replies; 1+ results
From: Michał Górny @ 2016-05-02 21:22 UTC (permalink / raw
  To: gentoo-project; +Cc: overlays

[-- Attachment #1: Type: text/plain, Size: 1176 bytes --]

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

-- 
Best regards,
Michał Górny
<http://dev.gentoo.org/~mgorny/>

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 949 bytes --]

^ permalink raw reply	[relevance 99%]

Results 1-1 of 1 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2016-05-02 21:22 99% [gentoo-project] [RFC] New Overlays project guide Michał Górny

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox