From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id A6299138334 for ; Wed, 11 Sep 2019 19:27:18 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 49883E0AAB; Wed, 11 Sep 2019 19:27:16 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id EFD06E0A93 for ; Wed, 11 Sep 2019 19:27:15 +0000 (UTC) Received: from katipo2.lan (unknown [203.86.205.69]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: kentnl) by smtp.gentoo.org (Postfix) with ESMTPSA id C1EC934B138 for ; Wed, 11 Sep 2019 19:27:14 +0000 (UTC) Date: Thu, 12 Sep 2019 07:27:05 +1200 From: Kent Fredric To: gentoo-dev@lists.gentoo.org Subject: [gentoo-dev] [RFC] A canonical source for QA Policies Message-ID: <20190912072705.0cd04899@katipo2.lan> Organization: Gentoo X-Mailer: Claws Mail 3.17.4 (GTK+ 2.24.32; x86_64-pc-linux-gnu) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply MIME-Version: 1.0 Content-Type: multipart/signed; boundary="Sig_/f9lhch.pLxOlUklZl5x31PK"; protocol="application/pgp-signature"; micalg=pgp-sha256 X-Archives-Salt: 345dbe56-522e-43ba-a21e-76156a7add0e X-Archives-Hash: 497c28fb2dab0a480c302ba966481f4f --Sig_/f9lhch.pLxOlUklZl5x31PK Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: quoted-printable Currently, to the best of my understanding, QA policies are spelt out scattered amongst the devmanual. This makes it very hard to: - Know what policies are in place - Know how to conform to each policy - Cite a given policy - Interpret a given policy unambiguously. Most of the dev-manual is written in the context of "If problem/task X -> do Y" But that doesn't really help for policy documentation. For policies to be effective, I feel we need something more like a list of policies, with numerical identifiers, with a short description of the policy (Similar to a GLEP title), which links to a document outlining what that policy means in detail. ie: [P-0001] Non-maintainer commits [P-0002] Maintainer assignment etc. Policies that are no longer "current" could be retained, but marked "inactive" ( meaning that the policy is no longer in effect, with the potential for a policy to be reinstated ), or policies could be marked as "tentative", where they're in semi-draft status and are trending towards enforcement. The hope here is that when a policy is violated, a clear citation can be made for which policy was violated. As it stands, it seems to be more like "read the whole dev manual again", "try googling the dev manual and get lucky", and sometimes "wring your hands over what the dev manual might say", or "ask QA to tell you what the policies are". None of these are ideal. --Sig_/f9lhch.pLxOlUklZl5x31PK Content-Type: application/pgp-signature Content-Description: OpenPGP digital signature -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEgdrME8Lrmai3DXYJda6SGagVg7UFAl15SokACgkQda6SGagV g7VCXxAAky9aBkd+dQyNUAaayi5bgNtYd5lYAsHAnW/4tfPdCJb3acNFSQAT6GIv X4CLIj3myPHidWa7Ln3WEFXoQkCov1twMnO8UKAwGqJiXXdhicLmw6XH+j3wEAZP ByKkLkOS594+lNKd4Wi2Q8H9o+Zh050oeovK5agI4cVAwbz0PMw2JRCn+trI8riS Uv2GM6wnz0oDi4IPIGUufvBPWvwn/V21mz+z23mnGtL1MLpGnusz/BRQvifzwKhe YwNFSntBdq+Rw7evk6SDmzIHiXPaLRSPaopx5KWX16STTD3wnaPAAGMe4yVrG8Do HAa/pGxgCACWdQMLBZ3FtBuGjPvu/z4rHZMyAbpq6JpbiiawRfL8B+WiBwru8BYK 5IKUkn/mNP64sWJI+2W8oS32lvWF/pnybc4dQPr+ymaFHwf0DSBsIF0htkv7vZsT dC1mGJfLwxJJKz6OaLi4I0XFkZlEsvMr4yljEcp1sW8ANWMHMlymVEHvHF4Csiar 70D7Wq9nzyssadVXSuLHKAyqe/uBUWbQAoyhBwWZq4iKH1ALJWwmp5wqXsrd8whg P45uDQxkUfqePVcRq4HLRW1JpUh5t80UVvjUOWAy6CV5RxZGiYqouu1tQFG2ov2J dhIfBpYFYFWd5X/DrBvBzdQ5XTcZvGQpVEAUi/5sq/dBkuzUQeo= =qfc2 -----END PGP SIGNATURE----- --Sig_/f9lhch.pLxOlUklZl5x31PK--