commit: e61cbdca52edcc1ff6bac20577722793703997ce Author: Sam James <sam <AT> gentoo <DOT> org> AuthorDate: Wed Jan 12 04:26:44 2022 +0000 Commit: Sam James <sam <AT> gentoo <DOT> org> CommitDate: Sat Jan 22 21:34:54 2022 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e61cbdca
keywording: add explanatory text on maintainer obligations Inspired partly by a discussion on a GitHub pull request [0]. [0] https://github.com/gentoo/gentoo/pull/23735 Signed-off-by: Sam James <sam <AT> gentoo.org> keywording/text.xml | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/keywording/text.xml b/keywording/text.xml index cc10166..ed6b6d1 100644 --- a/keywording/text.xml +++ b/keywording/text.xml @@ -243,6 +243,29 @@ to do this. <title>Moving from <c>~arch</c> to <c>arch</c></title> <body> +<p> +If a package has stable keywords, maintainers should regularly (subject to the +rules below) file stabilization bugs for their packages, ideally approximately +every 30 days after a new version is added. If a bug report for stabilization +is filed by somebody else, the maintainer should respond with an +acknowledgement ("ACK") if the ebuild is ready, and a negative +acknowledgement ("NAK") if not. +</p> + +<p> +Previous stable keywords should not be dropped without good cause and it is +courteous to ping members of the relevant arch team first. Maintainers must not +drop stable keywords simply because they don't have access to a platform: this +is what Gentoo's arch teams are here for. +</p> + +<p> +By convention, these bugs are assigned to package maintainers, but the only +action expected from maintainers is to acknowledge or reject the +stabilization rather than carry out additional testing on each required +architecture themselves. +</p> + <p> Stabilization, i.e., moving an ebuild from <c>~arch</c> ("testing") to <c>arch</c> ("stable"), is done by the relevant architecture teams. If you have