2021-12-10 09:34:01 -05:00
|
|
|
|
# How to Contribute
|
|
|
|
|
|
|
|
|
|
This guide explains how you can contribute to Nix, Nix packages or
|
|
|
|
|
NixOS.
|
|
|
|
|
|
2022-12-16 02:32:48 -05:00
|
|
|
|
:::{note}
|
|
|
|
|
Please also consider [contributing documentation](./documentation.md).
|
|
|
|
|
:::
|
|
|
|
|
|
2021-12-10 09:34:01 -05:00
|
|
|
|
## Report an issue
|
|
|
|
|
|
|
|
|
|
We can only fix issues that we know of, so please report any issue you
|
|
|
|
|
encounter.
|
|
|
|
|
|
2022-10-22 11:35:41 -04:00
|
|
|
|
Issues with the **package manager Nix** (including its documentation)
|
2021-12-10 09:34:01 -05:00
|
|
|
|
are reported at <https://github.com/NixOS/nix/issues>.
|
|
|
|
|
|
2022-10-22 11:35:41 -04:00
|
|
|
|
Issues with **specific packages or NixOS** (including its modules and
|
2021-12-10 09:34:01 -05:00
|
|
|
|
documentation) are reported at <https://github.com/NixOS/nixpkgs/issues>.
|
|
|
|
|
|
|
|
|
|
Make sure that there is not already an open issue for your problem.
|
|
|
|
|
Please follow the issue template and fill in all requested information
|
|
|
|
|
as they help us solve the problem.
|
|
|
|
|
|
|
|
|
|
You need a [GitHub] account for that.
|
|
|
|
|
|
2022-12-09 22:24:06 -05:00
|
|
|
|
[github]: https://github.com/
|
|
|
|
|
|
2021-12-10 09:34:01 -05:00
|
|
|
|
## Contribute to Nix
|
|
|
|
|
|
2022-12-09 22:24:06 -05:00
|
|
|
|
The package manager Nix is mostly written in C++.
|
|
|
|
|
|
|
|
|
|
If you want to contribute to its development, you can find
|
|
|
|
|
information on [how to setup a development environment] in the manual.
|
2021-12-10 09:34:01 -05:00
|
|
|
|
|
2022-12-09 22:24:06 -05:00
|
|
|
|
You can find inspiration for things to improve on the [issue tracker][nix issues].
|
2021-12-10 09:34:01 -05:00
|
|
|
|
|
|
|
|
|
Feel free to [join our community] to get in
|
|
|
|
|
contact with other developers.
|
|
|
|
|
|
2022-12-09 22:24:06 -05:00
|
|
|
|
[how to setup a development environment]: https://nixos.org/manual/nix/unstable/contributing/hacking.html
|
|
|
|
|
[nix issues]: https://github.com/NixOS/nix/issues
|
|
|
|
|
[join our community]: https://nixos.org/community
|
|
|
|
|
|
|
|
|
|
## Contribute to Nixpkgs
|
2021-12-10 09:34:01 -05:00
|
|
|
|
|
|
|
|
|
Packaging for Nix is simple when you have understood the basic concept.
|
|
|
|
|
|
2022-12-09 22:24:06 -05:00
|
|
|
|
[The Nixpkgs manual][nixpkgs quick-start] explains step-by-step how to add new packages to
|
|
|
|
|
the Nix package collection. There are also [programming language specific instructions].
|
2021-12-10 09:34:01 -05:00
|
|
|
|
|
2022-10-22 09:52:39 -04:00
|
|
|
|
You can find inspiration for things to improve in the [reported issues][nixpkgs issues].
|
|
|
|
|
|
2022-12-09 22:24:06 -05:00
|
|
|
|
[nixpkgs quick-start]: https://nixos.org/manual/nixpkgs/stable/#chap-quick-start
|
|
|
|
|
[programming language specific instructions]: https://nixos.org/manual/nixpkgs/stable/#chap-language-support
|
|
|
|
|
[nixpkgs issues]: https://github.com/NixOS/nixpkgs/issues?q=is%3Aopen+is%3Aissue+-label%3A%226.topic%3A+nixos%22+-label%3A%226.topic%3A+module+system%22+-label%3A%226.+topic%3A+nixos-container%22
|
|
|
|
|
|
2021-12-10 09:34:01 -05:00
|
|
|
|
## Contribute to NixOS
|
|
|
|
|
|
|
|
|
|
It’s pretty easy to contribute to NixOS compared to other linux
|
|
|
|
|
distributions. All the code is on GitHub in the repository [nixpkgs].
|
|
|
|
|
Everyone can propose an improvement and most of them get merged after a
|
|
|
|
|
review of the maintainers. You will get feedback in the pull request.
|
|
|
|
|
|
2022-12-09 22:24:06 -05:00
|
|
|
|
See the [NixOS manual][nixos manual dev] to get started and find all the details.
|
|
|
|
|
|
|
|
|
|
You can find inspiration for things to improve in the [reported issues][nixos issues].
|
2021-12-10 09:34:01 -05:00
|
|
|
|
|
2022-12-09 22:24:06 -05:00
|
|
|
|
There are also [issues tagged with good-first-bug] that are a good start for new
|
2021-12-10 09:34:01 -05:00
|
|
|
|
contributors.
|
|
|
|
|
|
|
|
|
|
Feel free to [join our community] of developers!
|
|
|
|
|
|
|
|
|
|
[nixpkgs]: https://github.com/NixOS/nixpkgs
|
2022-12-09 22:24:06 -05:00
|
|
|
|
[nixos manual dev]: https://nixos.org/manual/nixos/stable/index.html#ch-development
|
2022-10-22 09:52:39 -04:00
|
|
|
|
[nixos issues]: https://github.com/NixOS/nixpkgs/issues?q=is%3Aopen+is%3Aissue+label%3A%226.topic%3A+nixos%22
|
2022-12-09 22:24:06 -05:00
|
|
|
|
[issues tagged with good-first-bug]: https://github.com/NixOS/nixpkgs/labels/3.skill%3A%20good-first-bug
|