[gentoo-dev] Re: [gentoo-core] Portage, SLOT, functionality, documentation, ChangeLog

[Nick Jones <carpaski@gentoo.org>]

> Portage has an abhorrent lack of documentation, I'd like to see
> that changed. Possibly (especially) before a 1.4 release.

This is mentioned every once in a while, but to 'see that changed'
really does not help. SpanKY and a few other (greatly appreciated
individuals) make great contributions towards documenting all the
little bits that are missing, but, as you note, there is a lot that 
needs to be worked out. Time and I are not great friends, but I try
to keep up with what I make changes to (albeit most are only noted
in the changelog, make.conf, and emerge --help).

Care to help?

> A roadmap would also help a lot of people rest easy at night.
> Whether it is the case or not, it seems as if major changes take
> place in Portage on a whim. If they are planned, the general
> userbase has no foreknowledge of said plans and these changes
> come as a complete surprise when finally marked stable in the
> tree (if people even know they exist, due to the aforementioned
> lack of documentation).

Well... It's not on a whim... But I'll be working on improving
(read: creating) the public project plan/roadmap... as most of
it is my written notes and bugs.gentoo.org.

--NJ

--
gentoo-dev@gentoo.org mailing list