Contents

  1. General Information
    1. Packages information
  2. Joining the team
    1. Debian Salsa
    2. Debian Package Tracker
  3. Contributing to the Debian ROCm team
    1. Identifying and reporting bugs
    2. Bug triaging
    3. Fixing bugs
    4. Maintaining
  4. Packaging workflow
    1. Git workflow
    2. Debian CI with AMD GPUs
  5. Tasks for team-maintained ROCm packages
    1. Updating a package to a newer version
  6. Work-Needing and Prospective Packages

General Information

The Debian ROCm team maintains ROCm software and related packages in Debian. All packages are now hosted in the rocm-team group on salsa.

Packages information

Packages overview:

Debian Maintainer Dashboard for the team:

Bugs reported on packages maitained by the team:

Git repositories for the team:

Joining the team

Debian Salsa

Salsa is the name of a collaborative development server for Debian based on the GitLab software. Salsa is supposed to provide the necessary tools for package maintainers, packaging teams and other Debian related individuals and groups for collaborative development.

All git repositories maintained by the rocm-team are hosting on https://salsa.debian.org/rocm-team/. The repositories are all public. You should send merge requests for one-shot fixes. You can also request membership to the group rocm-team and wait for an admin to add you to the group. To speed up the procedure, send an email to the team email address debian-ai at lists.debian.org, stating your request to join the rocm-team group and preferably the package you intend to maintain under the team.

Once you submitted merge requests. Wait for other member to review your changes. We will have communication on the merges request. Once all issues solved and passed all salsa-ci tests, one of the Debian Developers in the team will do the merge and sponsor the upload.

Debian Package Tracker

Contributing to the Debian ROCm team

If you are a Debian enthusiast with basic Debian knowledge, you can help Debian ROCm team's activities. There are different ways to contribute to Debian ROCm team, which includes (and is not limited to)

Identifying and reporting bugs

If you are a user of the packages maintained by Debian lxqt team, you can help us by reporting the bugs you find in the packages using the Debian Bug Tracker http://bugs.debian.org/ or reportbug https://wiki.debian.org/reportbug tool. You can also add wishlist bugs about changes/features you would like to be added to the package so as to make it better to use.

Bug triaging

You can also help to triage bugs, by choosing bugs from https://bugs.debian.org/cgi-bin/pkgreport.cgi?dist=unstable;maint=debian-ai%40lists.debian.org or https://udd.debian.org/dmd.cgi?email1=debian-ai%40lists.debian.org , and try to

Fixing bugs

If you have knowledge in Debian, you can fix bugs that have been filed against the team maintained packages by providing patches and helpful information. Those like FTBFS bugs are often caused by test failures in packages and should be fixed to ensure reproducibility of the packages. Chances of bugs are more during transition of the lxqt version and any help in identifying, tagging and fixing them are much appreciated.

Maintaining

Maintenance of a package involves the tasks like updating a package to the latest version, keeping the package to be in accordance with the current Debian policies and standards etc.

Packaging workflow

We use git with git-buildpackage and pristine-tar together for each package on salsa. Before you continue, ensure you have installed the tools used by the team: 

apt-get install git-buildpackage pristine-tar

Git workflow

The following workflow is used for (almost) all non-native packages maintained by the lxqt team:

Debian CI with AMD GPUs

https://ci.rocm.debian.net/

Tasks for team-maintained ROCm packages

Updating a package to a newer version

Work-Needing and Prospective Packages