From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gentoo-dev+bounces-64545-garchives=archives.gentoo.org@lists.gentoo.org>
Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80])
	by finch.gentoo.org (Postfix) with ESMTP id 28583138247
	for <garchives@archives.gentoo.org>; Wed, 22 Jan 2014 23:52:17 +0000 (UTC)
Received: from pigeon.gentoo.org (localhost [127.0.0.1])
	by pigeon.gentoo.org (Postfix) with SMTP id 62F12E0B28;
	Wed, 22 Jan 2014 23:52:11 +0000 (UTC)
Received: from albert.telenet-ops.be (albert.telenet-ops.be [195.130.137.90])
	by pigeon.gentoo.org (Postfix) with ESMTP id 558C5E0B1A
	for <gentoo-dev@lists.gentoo.org>; Wed, 22 Jan 2014 23:52:09 +0000 (UTC)
Received: from TOMWIJ-GENTOO ([94.226.55.127])
	by albert.telenet-ops.be with bizsmtp
	id HBs71n00M2khLEN06Bs8nV; Thu, 23 Jan 2014 00:52:08 +0100
Date: Thu, 23 Jan 2014 00:51:01 +0100
From: Tom Wijsman <TomWij@gentoo.org>
To: vapier@gentoo.org
Cc: gentoo-dev@lists.gentoo.org
Subject: Re: [gentoo-dev] new profiles.desc header documenting
 profile/keyword policy
Message-ID: <20140123005101.5871b6f9@TOMWIJ-GENTOO>
In-Reply-To: <201401220158.05090.vapier@gentoo.org>
References: <201401200223.24912.vapier@gentoo.org>
	<20140120172613.GA6121@laptop.home>
	<201401220158.05090.vapier@gentoo.org>
X-Mailer: Claws Mail 3.9.0 (GTK+ 2.24.22; x86_64-pc-linux-gnu)
Precedence: bulk
List-Post: <mailto:gentoo-dev@lists.gentoo.org>
List-Help: <mailto:gentoo-dev+help@lists.gentoo.org>
List-Unsubscribe: <mailto:gentoo-dev+unsubscribe@lists.gentoo.org>
List-Subscribe: <mailto:gentoo-dev+subscribe@lists.gentoo.org>
List-Id: Gentoo Linux mail <gentoo-dev.gentoo.org>
X-BeenThere: gentoo-dev@lists.gentoo.org
Reply-to: gentoo-dev@lists.gentoo.org
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=PGP-SHA1;
 boundary="Sig_/zILA_2jRA9ic5eyvGITtg5v"; protocol="application/pgp-signature"
X-Archives-Salt: 4472d641-fd81-4f85-b392-4feb8d1ac67e
X-Archives-Hash: aa08cd0e15af7807f992ef70b4a7e908

--Sig_/zILA_2jRA9ic5eyvGITtg5v
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: quoted-printable

On Wed, 22 Jan 2014 01:58:04 -0500
Mike Frysinger <vapier@gentoo.org> wrote:

> On Monday 20 January 2014 12:26:13 William Hubbs wrote:
> > On Mon, Jan 20, 2014 at 02:23:24AM -0500, Mike Frysinger wrote:
> > > this has all been fairly ad-hoc in the past, so formalize it in
> > > the one place that impacts everyone -- profiles.desc.
> >=20
> > If it is policy, shouldn't it go in the dev manual rather than in
> > this file?
>=20
> maybe.  devmanual doesn't talk about this file at all atm.
>=20
> or maybe i still have it in my head that devmanual.g.o is the ad-hoc=20
> documentation and not a policy manual -- policy lives in the Gentoo
> Developer Handbook.

Parts of the policies at the end of the Gentoo Developer Handbook have
migrated to the development manual over the last week.

Those whom maintain it regard it as policy (qa@g.o, devmanual@g.o) as
far as I know, I have in the past also regarded it as such; to some
extent documentation should be based on policy, thus as a result I
think you can trust the documentation to be policy to a good extent.

The real policy is where the decisions are made, but as that's spread
across the council summaries and the mailing lists; that is what harder
to find I guess, with the ebuild policy now merging into the development
manual I think we really should see the development manual as policy.

The policy at the back of the Gentoo Developer Handbook was incomplete,
slightly outdated (CVS part, maybe some other unnoticed differences),
rarely came up in discussions (people often refer to devmanual
instead), ... thus I think its migration to the devmanual is progress.

--=20
With kind regards,

Tom Wijsman (TomWij)
Gentoo Developer

E-mail address  : TomWij@gentoo.org
GPG Public Key  : 6D34E57D
GPG Fingerprint : C165 AF18 AB4C 400B C3D2  ABF0 95B2 1FCD 6D34 E57D

--Sig_/zILA_2jRA9ic5eyvGITtg5v
Content-Type: application/pgp-signature; name=signature.asc
Content-Disposition: attachment; filename=signature.asc

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.22 (GNU/Linux)

iQEcBAEBAgAGBQJS4FllAAoJEJWyH81tNOV9ndkH/1amXhfFU+xbCx3GsvGCSl7d
Y81WnzfyxWortv6RhC9JWi/SJWfgHIhERylSxygWXOuAgdH0vkGw3YPGm6RDofYk
Cm78p/E3I+z5j/bRQV57AfRhixxT90l3VB5ug6AbCzozplU+Sa63dW/QPoaP9fBe
P4L1Oe1PiQFy+/678o15mYiZhouUtzlvNNtNKQ2c7+zLsLyynCVsOQbVvXbXFiYj
V6uqjWNSe3Yk0BLyI8ZUwJ59FUHoo1bxVZrGpw0KmoL0jAosN5A5DRe3z5i6jO9Y
ANE6NjvGw+lDfzRHzldzk5lt/iflajFlEGua8Bc7U/ppu+vIXNkbA1A4HKl/JjU=
=oTw2
-----END PGP SIGNATURE-----

--Sig_/zILA_2jRA9ic5eyvGITtg5v--