snlavaise/pmaports-rtwo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
14,868 Commits 1 Branch 0 Tags
main
Commit Graph
80 Commits
Author SHA1 Message Date
Pablo Correa Gómez fbcc0d8b8b docs: make the alsa-ucm-conf packaging bug as resolved 
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/9397>
 2026-08-24 12:16:54 +00:00
Oliver Smith d0177ce4af docs: fix apkbuild-metadata file path 
The file was supposed to be in
docs/packaging/ui-packages/apkbuild-metadata.md. Put it there, so it
shows up in the rendered docs.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/9391>
 2026-08-17 11:18:05 +00:00
Aster Boese 0501456bf7 docs: split out UI package APKBUILD metadata 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8545>
 2026-08-15 18:58:27 +02:00
Aster Boese 3522ba4279 docs: document service manager options for UIs 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8545>
 2026-08-15 18:58:26 +02:00
Pablo Correa Gómez 8722dd75aa ci: add a tag to allow skipping hw-ci jobs 
There is the ocasional or rare case in which this can be useful
independently of [ci:skip-build], like if something is very urgent and
blocked due to something that only affects HW-CI. We already do not
block merging if actual HW fails the tests to avoid reliability
issues, so this is purely for software bugs.

Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/9348>
 2026-08-08 20:40:30 +00:00
Pablo Correa Gómez a909b503e9 docs: ci: ci-tags: order alphabetically 
So adding new info feels less random

Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/9348>
 2026-08-08 20:40:30 +00:00
Pablo Correa Gómez 990c2dd235 docs: fix generic-kernel-packages example code block 
Solves https://gitlab.postmarketos.org/postmarketOS/pmaports/-/work_items/4784

Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/9256>
 2026-08-05 15:58:18 +00:00
Aster Boese f85c1bceba docs: mark v25.12 as EOL 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/9247>
 2026-08-05 00:10:12 +00:00
Clayton Craft 77a6de8660 docs/generic-kernels: clarify requirements, guidance for adding options 
Here are some things I noticed while adding options to generic kconfig,
that I think would have been helpful for me to know ahead of time.

Signed-off-by: Clayton Craft <craftyguy@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/9163>
 2026-07-28 11:45:41 -07:00
Aster Boese bc290e18a8 docs: document splitting kconfig MRs logically 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/9059>
 2026-07-17 13:56:46 +00:00
Aelin 9bde5f7056 docs/generic-kernels: Mention linux-next 
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/7937>
 2026-07-11 02:30:02 +02:00
Aster Boese f039294ad6 docs: document default kconfig fragments defconfig logic 
[ci:skip-grep]
[ci:skip-kconfigcheck]
[ci:skip-vercheck]

Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8978>
 2026-07-08 23:22:48 +00:00
Aster Boese b00b2a23d7 docs: reaffirm not using contributor comments 
This was first brought up in pmaports#543, but a few contributor
comments have snuck in over time. This reaffirms that we don't use
them.

Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8950>
 2026-07-06 20:41:40 +02:00
Aster Boese 4db7d49d53 treewide: stop calling or recommending doas 
With the switch to sudo-rs, v26.06 and edge installs do not have
doas by default. Along with this, we installed doas on old installs
with doas-sudo-shim, so the call to sudo also works there. Therefore,
recommending and calling sudo is the correct option here.

Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8873>
 2026-06-26 09:11:27 +00:00
bluebunny 0fdb7af58f docs: packaging: remove maintainership exception clause 
v26.06 is released, and unmaintained packages were archived with !8883. Remove the
now outdated clause.

Signed-off-by: bluebunny <bluebunny@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8896>
 2026-06-24 11:00:02 +00:00
Oliver Smith 3c2ff259b4 docs: releases: mark v26.06 as released 
Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8879>
 2026-06-21 15:34:49 +02:00
bluebunny e015e4359c docs: device-categorization: fix duplicate typo 
Signed-off-by: bluebunny <bluebunny@postmarketos.org>
 2026-06-19 12:53:37 +00:00
Pablo Correa Gómez ada7990f8e docs: add that lowering main or community devices requires communication 
Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8595>
 2026-06-19 11:41:19 +00:00
Pablo Correa Gómez 85dc562881 docs: add rationales for device categories 
The lack of rationales for device categorization has lead to a lot of
discussions, misunderstandings, and frustrations, as of why the
requirements are the way they are. Even though it's always good to
keep improving and exploring ways to change our processes, having
rationales can help to explain the "why"s that do not really get
addressed by the "how"s of the actual requirements. Hopefully, this
will lead to less discussions and misunderstandings around the
specific requirements.

Closes https://gitlab.postmarketos.org/postmarketOS/postmarketos/-/work_items/146

Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8595>
 2026-06-19 11:41:19 +00:00
Aster Boese 9f4e4777a8 docs: reference Alpine Linux's CODINGSTYLE.md 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8847>
 2026-06-18 13:39:33 +00:00
Oliver Smith 9b29c2bc2c docs: stable-branches: backports may wait 
Let's note that maintainers can choose to delay backports to give them
more testing time.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8850>
 2026-06-17 19:45:54 +02:00
Oliver Smith 2f121a4d14 docs: integrate COMMITSTYLE 
Make a symlink at docs/merge-requests/commitstyle.md that points at the
COMMITSTYLE.md file, so it is part of the documentation at
https://docs.postmarketos.org/pmaports/.

Tweak the headline and link to Alpine's COMMITSTYLE.md so it looks
better in the version rendered at docs.postmarketos.org.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8829>
 2026-06-16 13:40:21 +00:00
Oliver Smith 4084d06f7b docs: approval-rules: simplify for stable branches 
Don't describe how MRs to stable branches are done here, link to the
other page instead. Otherwise the approval rules should be the same as
for stable branches from now on.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8812>
 2026-06-16 13:30:02 +02:00
Oliver Smith 8d534ae3d6 docs: update merge-requests/stable-branches 
* Describe relevant changes, especially that we may make non-backport
  changes if there is a patch release for a package that meanwhile has a
  higher version in main already (e.g. a kernel in main is on linux
  7.x.y while stable is on 6.18.z).

* Directly pushing to a stable branch should only be done during initial
  branch bringup, otherwise we shall always make MRs that go through CI.

* Update formatting and title of the page.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8812>
 2026-06-16 13:30:01 +02:00
Oliver Smith d13bed7d56 docs: make headlines more consistent 
Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8812>
 2026-06-16 13:27:58 +02:00
Oliver Smith 5b69893122 docs: structure: move packaging related pages 
Bring more structure into the docs by moving packaging related subpages
as well.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8812>
 2026-06-16 13:27:25 +02:00
Oliver Smith ac931d4507 docs: structure: move merge-requests related pages 
Add a new "merge requests" page and move all related pages under that
page to give the docs more structure.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8812>
 2026-06-16 13:27:22 +02:00
Oliver Smith ae07d28bfb docs: structure: move CI related pages 
Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8812>
 2026-06-16 13:24:21 +02:00
Oliver Smith ad05a1b83b docs/releases/timeline: add numbers before phases 
Adjust the timeline docs and release infrastructure template to have
numbers before the phases. This makes clearer where the next phase
begins in the long infrastructure issue template.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8815>
 2026-06-15 19:23:56 +00:00
Aster Boese fb74aa230e docs: document how to create a UI package 
Updates and replaces https://wiki.postmarketos.org/wiki/UI_specific_package,
being a bit more specific as to what is expected out of a UI package and
how exactly to create one.

Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8720>
 2026-06-10 07:26:39 +00:00
bluebunny 9a8530c89b docs: make package versioning more detailed 
The old wiki page "Packaging" [1] had more information on when to bump packages,
but it was omitted when migrating to docs.postmarketos.org. Revive the section
and reword the sentences a bit, so that there will be no confusion that the
version of a package should always be bumped.

[1]: https://wiki.postmarketos.org/index.php?title=Packaging&oldid=68927#When_should_pkgver/pkgrel_get_increased?

Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8739>
 2026-06-09 05:29:54 +00:00
Oliver Smith 1a6c9dda36 docs: fix typo: maintainance -> maintenance 
Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8738>
 2026-06-07 13:12:35 +02:00
Oliver Smith 734884e864 CI: apkbuild-lint: add a skip-apkbuild-lint tag 
As we are now moving to a newer, stricter version, we might want to skip
fixing APKBUILDs in some MRs. And this is in general useful to have.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8735>
 2026-06-07 10:09:20 +00:00
Aelin f948899cb0 docs: Add approval rules flowchart 
Apparently our rules are complicated enough that this is necessary. I am
*not* an expert at Inkscape, so bear with me. This is also my
interpretation of the rules, if I got anything wrong, please correct me.

Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8719>
 2026-06-05 13:07:15 +00:00
Oliver Smith 879b7a6dbc docs: update release timeline 
Move the test week by one week, the package repository isn't ready just
yet.

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8713>
 2026-06-02 15:34:17 +02:00
Aelin 2dcfeceda0 docs: device-categorization: Don't special-case CC approvals 
As far as I can tell, this was overlooked so far when going over things
where we still differentiate between CCs and TCs.

Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8705>
 2026-06-01 17:02:50 +00:00
Aster Boese 1a482a2b17 docs: add skip-grep 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8652>
 2026-05-27 15:29:19 +02:00
Aster Boese 5e7cac3f31 docs: document requirement for mainline kernels to be built with LLVM 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8546>
 2026-05-18 20:48:08 +00:00
Aster Boese aacb35f760 docs: document version cutoff for mainline kernels 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8546>
 2026-05-18 20:48:08 +00:00
Pablo Correa Gómez 6112038d86 docs: remove requirement for maintainer from community devices 
This is a general packaging guideline.

Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8508>
 2026-05-08 21:49:46 +00:00
Pablo Correa Gómez e3f06aba45 docs: add section about maintainership to packaging guidelines 
Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8508>
 2026-05-08 21:49:46 +00:00
Pablo Correa Gómez b293a8e354 docs: place the provides section of the packaging guidelines at the end 
It is quite massive, and therefore let's put the simpler things
first. If things keep growing, at some point it would make sense to
move it out to a subpage.

Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8508>
 2026-05-08 21:49:43 +00:00
Pablo Correa Gómez 0b505f0189 docs: cleanup wording of device-categorization. 
"2021-11" is completely unnecessary at this point, and adding that the
kernel must be upgraded regularly is redundant with the requirement of
3 kernel releases and a lot less objective. So keep the objective
wording and remove the one very up for interpretation.

Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8505>
 2026-05-07 16:44:53 +00:00
Pablo Correa Gómez 5e180a8f0b docs: fix heading level of archived category 
Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8505>
 2026-05-07 16:44:53 +00:00
Oliver Smith c52e7b1556 docs: add release documentation 
Move and update release documentation from these wiki pages to pmaports
docs:
* https://wiki.postmarketos.org/wiki/Releases
* https://wiki.postmarketos.org/wiki/Creating_a_release_branch#Timeline

Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8486>
 2026-05-05 12:48:41 +00:00
Aelin 6d11555054 docs/kconfigcheck: Clarify version baselines 
It is extremely tedious to keep track of what the name of a particular
option was for every kernel release and when they were added. To keep
kconfigcheck maintainable, let's ease the burden on people adding new
options for community categories or other categories only required by
close-to-mainline kernel packages and only have them look back a
reasonable number of kernel versions.

Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8407>
 2026-04-22 16:12:29 +00:00
Achill Gilgenast e38532b7f7 ci: relax pkgrel changes for packages that don’t have remote sources 
Motivation is to avoid unnecessary overhead for MR authors & no reason to
actually use pkgrel for meta-packages.

So instead, recommend pkgver-bumps & pkgrel=0 for metapackages, but don't
block MRs when they bumped the "wrong" one. Just make everyone's life easier.

Discussed at <https://docs.postmarketos.org/policies-and-processes/governance/team-meetings/meeting-notes.html> (2026-03-16)

Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8302>
 2026-04-10 12:08:26 +00:00
Oliver Smith a82d50bb51 docs: device-categorization: new main requirements 
Featuring a minor wording tweak as suggested by Newbyte.

Related: https://docs.postmarketos.org/pmcr/main/0009-new-main-device-category.html
Signed-off-by: Oliver Smith <ollieparanoid@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/8237>
 2026-03-29 16:47:50 +02:00
Aster Boese 7d8b935704 treewide: change pmaports-specific master strings to main 
Signed-off-by: Aster Boese <asterboese@mailbox.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/7566>
 2026-03-15 13:54:37 +00:00
Pablo Correa Gómez 2e12f24b15 docs: add documentation on how hw-ci integration works in this repo 
[ci:skip-vercheck] gitlab-ci.yml.j2 files changed

Signed-off-by: Pablo Correa Gómez <pabloyoyoista@postmarketos.org>
Part-of: <https://gitlab.postmarketos.org/postmarketOS/pmaports/-/merge_requests/7881>
 2026-03-12 19:17:36 +00:00