Portmod Developer Guide

Contributing to Portmod

There are many different ways you can contribute to Portmod. With the exception of Localisation, all of these contributions will require the use of git.

If you are unfamiliar with git you may want to check out the GitLab Basics Guide.

In particular, you may want to look at:

  • Making your first commit, which guides you through the basics of git, gitlab, and commits.

  • Forking Workflow, which describes how to use forks to contribute to projects you don’t have write access to.

Contributing to Portmod or its subprojects means that you are licensing your contributions under the GPL version 3 or later.

Setting up a local clone

You will need to fork the repository you wish to contribute to (look for the fork button in the top right of the project page).

Make a local copy of your fork:

git clone git@gitlab.com:<user>/<repo>.git


Documentation is written using Sphinx and reStructuredText.

All documentation should be written in British English (en-GB). Sphinx documentation can be internationalised, but this has not yet been set up. If you are interested in contributing translations of the documentation, please open an issue on the issue tracker.


Packaging Mods

Working with Package Repositories

Contributing to Portmod’s Package Mangager Code