From e3f06aba4559a284b58e7ff9046612dbd0fd34da Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pablo=20Correa=20G=C3=B3mez?= Date: Fri, 8 May 2026 15:39:38 +0200 Subject: [PATCH] docs: add section about maintainership to packaging guidelines MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Pablo Correa Gómez Part-of: --- docs/device-categorization.md | 1 + docs/packaging-guidelines.md | 29 +++++++++++++++++++++++++++++ 2 files changed, 30 insertions(+) diff --git a/docs/device-categorization.md b/docs/device-categorization.md index 0f98d8ebd..69c973ef7 100644 --- a/docs/device-categorization.md +++ b/docs/device-categorization.md @@ -125,6 +125,7 @@ once a mainline port appears. Kernels and devices in this category might be moved to _archived_ if no longer building and either lack a maintainer or the maintainer is unresponsive for months. +(device-category-archived)= ### Archived Ports are moved to this category if: diff --git a/docs/packaging-guidelines.md b/docs/packaging-guidelines.md index c6edcd005..4f382c037 100644 --- a/docs/packaging-guidelines.md +++ b/docs/packaging-guidelines.md @@ -1,5 +1,34 @@ # Packaging Guidelines +## Maintainership + +Every package is expected to have a maintainer. The only exception is packages +in the [Archived](#device-category-archived) category. + +Maintainers are identified by the maintainer variable in the `APKBUILD` of the +package like: + +```sh +maintainer="Jane Doe " +``` + +The email should be added to the gitlab user of the maintainer, to make it +possible for the user to be pinged when doing changes. The name can be any +identifier the maintainer uses online or in person. + +Packages can also have Co-Maintainers, which are identified by a comment like: + +```sh +# Co-Maintainer: John Doe +``` + +Maintainers and Co-Maintainers will be pinged whenever changes to their packages +are made. + +Enforcing of this guideline [will +wait](https://postmarketos.org/devel/2026/03/24/archiving-unmaintained-devices/) +for v26.06 to be released. + ## Meta packages ### Package versioning (pkgver, pkgrel)