# Welcome to pmaports' documentation!

pmaports is the repository that holds the package build definitions in
postmarketOS.

When porting a new device or doing maintainance work around the distribution,
you will usually be working inside of pmaports.

This documentation section covers the Dos and Don'ts of packaging software
in pmaports and the processes around device categorization.

```{eval-rst}
.. toctree::
   :hidden:

   releases
   approval-rules
   device-categorization
   deviceinfo-reference
   ci-tags
   firmware
   generic-device-packages
   generic-kernels
   hardware-ci
   kconfig-fragments
   kconfigcheck
   kernel-cmdline
   kernel-versions
   packaging-guidelines
```