[gentoo-dev] Portage, SLOT, functionality, documentation, ChangeLog

[Stewart Honsberger <blkdeath@gentoo.org>]

I've talked about this several times, but I wanted to get it out in the 
open;

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

There are dozens upon dozens of facets of key functionality that are 
simply not
explained, or not clearly explained. If they are, they're given a 
sentence here and there,
scattered all about the Gentoo website, man/info pages, CVS, etc.

Also, and I can't stress this enough, a ChangeLog is *required*. When 
key functionality
is introduced, updated, removed, or significantly altered, it is 
imperative that users
and developers alike can be easily appraised of it in a common location.

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).

Thoughts? Ideas?

-- 
Stewart Honsberger
http://blackdeath.snerk.org/
"Capitalists, by nature, organize to protect themselves.
-- Geeks, by nature, resist organizaion."


--
gentoo-dev@gentoo.org mailing list