Piecuu/pmaports
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

docs: add section about maintainership to packaging guidelines

Browse source 
Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8508>
This commit is contained in:
Pablo Correa Gómez 2026-05-08 15:39:38 +02:00 • committed by The Friendly Meow (merge) Bot
parent b293a8e354
commit e3f06aba45
No known key found for this signature in database
2 changed files with 30 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1
docs/device-categorization.md
View file

@ -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:

29
docs/packaging-guidelines.md
View file

@ -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 <jane@example.org>"
```
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 <john@example.org>
```
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)