[gentoo-releng] Profile documentation and upgrading doc

[gentoo-releng] Profile documentation and upgrading doc

[Sven Vermeulen]

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

Hi all,

The GDP has received a nice contribution document which covers the upgrading
part of a Gentoo installation. More importantly, it tries to document the
use of profiles and when a user needs to change his profile symlink.

Profiles are one of the less documented aspects of a Gentoo installation and
I think such a document is really interesting. However, because it's not
that documented and transparent to the user, I cannot verify validity of the
document (and it's not something that can be tested as well).

Can all profile experts and architectural release coordinators check the
content of http://dev.gentoo.org/~swift/gentoo-upgrading.html and see if it
contains any falsehoods, mistruths or is missing vital information?

Wkr,
      Sven Vermeulen

-- 
 Bent Hindrup Andersen, Danish MEP, about the Software Patent Directive:
    The approach of the Commission and Council in this directive is shocking. 
    They are making full use of all the possibilities of evading democracy that 
    the current Community Law provides.     <http://lwn.net/Articles/84009/>

[-- Attachment #2: Type: application/pgp-signature, Size: 189 bytes --]

Re: [gentoo-releng] Profile documentation and upgrading doc

[John Davis]

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

On Mon, 2004-05-10 at 15:04, Sven Vermeulen wrote:
> Hi all,
> 
> The GDP has received a nice contribution document which covers the upgrading
> part of a Gentoo installation. More importantly, it tries to document the
> use of profiles and when a user needs to change his profile symlink.
> 
> Profiles are one of the less documented aspects of a Gentoo installation and
> I think such a document is really interesting. However, because it's not
> that documented and transparent to the user, I cannot verify validity of the
> document (and it's not something that can be tested as well).
> 
> Can all profile experts and architectural release coordinators check the
> content of http://dev.gentoo.org/~swift/gentoo-upgrading.html and see if it
> contains any falsehoods, mistruths or is missing vital information?
> 
> Wkr,
>       Sven Vermeulen

Very well done - especially the release philosophy bit. You hit releng's
main function right on the nose.

The content is very good, and the only problem that I could find is the
lack of a heading for the supported profiles table. Could you perhaps
add in some <th>'s so that the users know what they are looking at in
those columns?

Cheers,
-- 
John Davis
Gentoo Linux Developer
<http://dev.gentoo.org/~zhen>

----
GnuPG Public Key: <http://dev.gentoo.org/~zhen/zhen_pub.asc>
Fingerprint: 2364 71BD 4BC2 705D F338  FF70 6650 1235 1946 2D47


[-- Attachment #2: This is a digitally signed message part --]
[-- Type: application/pgp-signature, Size: 189 bytes --]