Project Maintainers

postmarketOS hosts various repositories at https://gitlab.postmarketos.org/postmarketOS.

This page describes by whom these different projects are maintained and how maintainership is handled for these repositories.

maintainers.txt files

Repositories in the postmarketOS namespaces may have a maintainers.txt text file in the root directory. This file is the list of who maintains this repository. It includes each maintainer’s gitlab username per line. Please keep this file sorted and include the header comment to this page.

Example:

# https://postmarketos.org/maintainers.txt
Aelin
PureTryOut
fossdd

The exception for this file are collectivly maintained projects like pmaports.

A file without maintainers declares the project as unmaintained. A missing file doesn’t necessarily mean that the project is unmaintained, but that it might not have yet been migrated to the maintainers.txt-format.

Maintainer powers

As a project maintainer you get the following powers:

  • Approve and merge all MRs on your project, see Code Review / Merge

  • Tag new releases

  • Accept new maintainers

Maintainer expectations

“With great power comes great responsibility” and we expect you to follow the following aspects:

  • Review (and merge) MRs assigned to your project in a reasonable time

  • Keep track of the issue tracker (e.g. make sure issues have enough info by the reporter).

  • Ideally subscribe to all activity in your project via Gitlab

Becoming a maintainer

To become a maintainer we expect you to get in contact with the existing maintainers first and discuss your maintainership. If the current maintainers agree, open a MR adding yourself to the maintainers.txt file of the project.

If the project is unmaintained (i.e. the maintainers.txt file is empty), or maintainers are unresponsive you can directly send a MR adding yourself as maintainer, and ask TCs/CCs to merge the MR. If you’re a TC/CC, you can directly merge the MR.

Now that you’re a maintainer of a project, you can ask the infra team to receive the Maintainer role on gitlab for the repository.

To remove your maintainership, delete the line and push it to the main branch.