From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 4220 invoked by uid 1002); 12 Jul 2003 19:00:39 -0000 Mailing-List: contact gentoo-dev-help@gentoo.org; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@gentoo.org Received: (qmail 29537 invoked from network); 12 Jul 2003 19:00:39 -0000 Message-ID: <3F105B0D.8050200@gentoo.org> Date: Sat, 12 Jul 2003 15:01:33 -0400 From: Stewart Honsberger Organization: Gentoo Technologies User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.4) Gecko/20030709 X-Accept-Language: en-us, en MIME-Version: 1.0 To: gentoo-dev@gentoo.org Cc: gentoo-core@gentoo.org X-Enigmail-Version: 0.76.1.0 X-Enigmail-Supports: pgp-inline, pgp-mime Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Subject: [gentoo-dev] Portage, SLOT, functionality, documentation, ChangeLog X-Archives-Salt: 2656dd49-50e3-4d0e-9744-da1fc8202636 X-Archives-Hash: 8fc9caf63b01704b342c9add1d04a8f8 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