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 E6B631382C5 for ; Sun, 14 Mar 2021 19:57:20 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 34421E0827; Sun, 14 Mar 2021 19:57:20 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (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 E03B9E0827 for ; Sun, 14 Mar 2021 19:57:19 +0000 (UTC) Received: from oystercatcher.gentoo.org (unknown [IPv6:2a01:4f8:202:4333:225:90ff:fed9:fc84]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id E1C1D340C58 for ; Sun, 14 Mar 2021 19:57:18 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 97BE013B for ; Sun, 14 Mar 2021 19:57:17 +0000 (UTC) From: "Michał Górny" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Michał Górny" Message-ID: <1614538974.824f0fcd9a466ca69e9705bd2f380ccac768151a.mgorny@gentoo> Subject: [gentoo-commits] data/glep:master commit in: / X-VCS-Repository: data/glep X-VCS-Files: glep-0067.rst X-VCS-Directories: / X-VCS-Committer: mgorny X-VCS-Committer-Name: Michał Górny X-VCS-Revision: 824f0fcd9a466ca69e9705bd2f380ccac768151a X-VCS-Branch: master Date: Sun, 14 Mar 2021 19:57:17 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 20cfc32a-04cf-4e0d-96fc-9ad289edeb4a X-Archives-Hash: 1748a7e35a73035e854243eb1e853a39 commit: 824f0fcd9a466ca69e9705bd2f380ccac768151a Author: Michał Górny gentoo org> AuthorDate: Sun Feb 28 11:33:38 2021 +0000 Commit: Michał Górny gentoo org> CommitDate: Sun Feb 28 19:02:54 2021 +0000 URL: https://gitweb.gentoo.org/data/glep.git/commit/?id=824f0fcd glep-0067: Add proxied="" attribute to distinguish proxied maints Introduce an additional proxied="" attribute to make it possible to explicitly distinguish proxied maintainers from regular maintainers. This is supposed to resolve false positives in the QA check responsible for detecting leftover proxy-maint project usage. Currently it wrongly assumes that all Gentoo devs (as in people with @gentoo.org) have direct push access and therefore don't need a proxy. Signed-off-by: Michał Górny gentoo.org> glep-0067.rst | 53 +++++++++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 47 insertions(+), 6 deletions(-) diff --git a/glep-0067.rst b/glep-0067.rst index e22f216..8140b15 100644 --- a/glep-0067.rst +++ b/glep-0067.rst @@ -4,10 +4,10 @@ Title: Package maintenance structure Author: Michał Górny Type: Standards Track Status: Final -Version: 1 +Version: 1.1 Created: 2015-12-13 -Last-Modified: 2016-01-13 -Post-History: 2015-11-03, 2016-05-29 +Last-Modified: 2021-02-28 +Post-History: 2015-11-03, 2016-05-29, 2021-02-28 Content-Type: text/x-rst --- @@ -23,6 +23,13 @@ Maintainer listings in ``metadata.xml`` become uniform, and can be used directly to assign bugs. +Change log +========== + +v1.1 + Added the ``proxied`` attribute to the package ````. + + Motivation ========== @@ -144,19 +151,35 @@ of the ```` element. The e-mail address, human-readable name and maintenance description are placed in ````, ```` and ```` sub-elements appropriately. +Optionally, a ``proxied`` attribute can be specified having one +of the three possible values: + +- ``yes`` indicating that the maintainer is a proxied maintainer + (i.e. is unable to push changes directly) + +- ``no`` indicating that the maintainer is a real maintainer (i.e. can + push changes directly) + +- ``proxy`` indicating that the listed developer is serving only + as a proxy for other maintainers + +If the attribute is not specified, the default value of ``no`` +is assumed. If at least one maintainer is listed as a proxied +maintainer (``proxied="yes"``), then at least one other maintainer +should be listed as a proxy (``proxied="proxy"``), and vice versa. + .. code:: xml - + foo@example.com Foo Barsky - Proxied maintainer example@gentoo.org Example Developer - + proxy-maint@gentoo.org @@ -428,6 +451,24 @@ maintainers can add themselves to ``metadata.xml`` in a single commit to the repository. If external database was used, the database would have to be updated in addition to the repository commit. +Proxied maintainers +------------------- + +As of version 1.1, an additional ``proxied`` attribute has been added +to the ```` element for package maintainers. This is used +to explicitly distinguish regular developers, proxied maintainers +and proxies. + +The primary purpose is to resolve false positives in the QA report used +to report leftover proxy-maint project instances, as well as improve +detection of maintainers without a proxy. Currently, these checks +unconditionally assume that all Gentoo developers have commit access, +and everyone else is a proxied maintainer. This does not account for +developers without commit access that maintain packages via a proxy. + +The property is added as a separate attribute in order to ensure +backwards compatibility. + Backwards Compatibility =======================