Skip to content

debexpo/debexpo

Repository files navigation

Debexpo

debexpo is the software running behind https://mentors.debian.net.

It allows contributors to debian packaging to propose new software for inclusion into Debian.

The source is available from:

https://salsa.debian.org/mentors.debian.net-team/debexpo

Licensing and authors

debexpo is released under the MIT license available in the COPYRIGHT file.

Current and former contributors are listed into the AUTHORS file.

Documentation

The debexpo documentation is written in reStructuredText and can be found inside the docs/ directory. You can find the current installation guide at docs/installing.rst. You can build and view the HTML docs locally by executing:

% sudo apt install python3-sphinx # needed to build the docs
% cd docs/
% make html
% sensible-browser _build/html/index.html

Installing

Installation documentation is available in docs/installing.rst.

Contributing

Report a bug

To report a bug to debexpo, please fill-in an issue at this URL:

https://salsa.debian.org/mentors.debian.net-team/debexpo/issues

Include as much information as you can. We must be able to reproduce the crash in order to fix it.

Contribute to debexpo

If you have enough knowledge (or willingness to learn) python, django and debian packaging, you can help hacking debexpo code to add new feature or fix bugs reported on the issue tracker.

The current workflow for contributing is:

  • Fork debexpo project to your personal workspace
  • Work on a dedicated branch. (you can prefix your branch by fix/, feature/, doc/)
  • When the hack is ready AND covered by tests, create a new merge request against the live branch for us to review.

We do ask that any code added/modified is covered by tests before merging.

Don't hesitate to join us on IRC (detail below).

Translating

Translation for debexpo are managed by the weblate project:

https://hosted.weblate.org/projects/debexpo/

We will pull translation periodically from weblate and synchronize it to debexpo main repository.

When a language is at least 95% translated, it will become available on mentors.debian.net. If it fall under 75%, it will be removed from available languages.

Contact

You can reach us by email using the address support@mentors.debian.net.

For any question, we also are available on the IRC channel #debexpo from the OFTC network.