Contribute

Issues, ideas and pull requests are welcome in every project.

Ways in

Start small. Every report helps.

Report a problem

Say what you did, what you expected and what happened, with your distribution and versions. Replace anything personal, like a monitor's serial, before pasting output.

Suggest an idea

A widget for an app you use, a setting you miss, a rough edge. Open an issue with the feature form and describe the problem before the solution.

Send a change

Fork, branch, and open a pull request against main. Each project's CONTRIBUTING file says how to run its tests; run them before you push.

The conventions, in short

  • Branches are <type>/<what>, like feat/weather-radar.
  • Commits are <type>(<scope>): <description>, 72 characters at most: feat, fix, docs, refactor, test, chore, perf, ci.
  • One change per pull request, with tests for what it changes.
  • Be kind. The code of conduct applies in every project.
The full conventions →