1
0
Fork 0
mirror of https://github.com/NixOS/nix.dev.git synced 2024-10-18 14:32:43 -04:00
nix.dev/source/contributing/how-to-get-help.md
Valentin Gagarin 3b5fee627c update contributing guides
- clarify a few phrases
- move Open Collective link to the top
- add section headings for easier navigation
- add a few details on contacting people
2024-02-05 13:42:29 +01:00

3 KiB

How to get help

If you need assistance with one of your contributions, there are a few places you can go for help.

How to find maintainers

For better efficiency and higher chance of success, you should try contacting individuals or groups with more specific knowledge first:

  • If your contribution is for a package in Nixpkgs, look for its maintainers in the maintainers attribute.
  • Check if any teams are responsible for the relevant subsystem:
  • Check the output of git blame or git log for the files you need help with. Take note of the email addresses of people who committed relevant code.

Which communication channels to use

Once you've found the people you're looking for, you can contact them on one of the following platforms:

  • GitHub

    All the source code is maintained on GitHub. This is the right place to discuss implementation details.

    In issue comments or pull request descriptions, mention the GitHub username found in the maintainers-list.nix file.

  • Discourse

    Discourse is used for announcements, coordination, and open-ended questions.

    Try the GitHub username found in the maintainers-list.nix file to mention or directly contact a specific user. Note that some people use a different username on Discourse.

  • Matrix

    Matrix is used for direct messages and short-lived, timely exchanges.

    To contact a maintainer, use their Matrix handle found in the maintainers-list.nix file. If no Matrix handle is present for a specific maintainer, try searching for their GitHub username, as most people tend to use the same one across channels.

    Maintainer teams usually have their own public Matrix room.

  • Email

    Use email addresses found with git log.

Other venues

If you haven't found any specific users or groups that could help you with your contribution, you can resort to asking the community at large, using one of the following official communication channels: