|
| 1 | +# Contributing to nix |
| 2 | + |
| 3 | +We're really glad you're interested in contributing to nix! This |
| 4 | +document has a few pointers and guidelines to help get you started. |
| 5 | + |
| 6 | +To have a welcoming and inclusive project, nix uses the Rust project's |
| 7 | +[Code of Conduct][conduct]. All contributors are expected to follow it. |
| 8 | + |
| 9 | +[conduct]: https://www.rust-lang.org/conduct.html |
| 10 | + |
| 11 | + |
| 12 | +# Issues |
| 13 | + |
| 14 | +We use GitHub's [issue tracker][issues]. |
| 15 | + |
| 16 | +[issues]: https://github.com/nix-rust/nix/issues |
| 17 | + |
| 18 | + |
| 19 | +## Bug reports |
| 20 | + |
| 21 | +Before submitting a new bug report, please [search existing |
| 22 | +issues][issue-search] to see if there's something related. If not, just |
| 23 | +[open a new issue][new-issue]! |
| 24 | + |
| 25 | +As a reminder, the more information you can give in your issue, the |
| 26 | +easier it is to figure out how to fix it. For nix, this will likely |
| 27 | +include the OS and version, and the architecture. |
| 28 | + |
| 29 | +[issue-search]: https://github.com/nix-rust/nix/search?utf8=%E2%9C%93&q=is%3Aissue&type=Issues |
| 30 | +[new-issue]: https://github.com/nix-rust/nix/issues/new |
| 31 | + |
| 32 | + |
| 33 | +## Feature / API requests |
| 34 | + |
| 35 | +If you'd like a new API or feature added, please [open a new |
| 36 | +issue][new-issue] requesting it. As with reporting a bug, the more |
| 37 | +information you can provide, the better. |
| 38 | + |
| 39 | + |
| 40 | +## Labels |
| 41 | + |
| 42 | +We use labels to help manage issues. The structure is modeled after |
| 43 | +[Rust's issue labeling scheme][rust-labels]: |
| 44 | +- **A-**prefixed labels state which area of the project the issue |
| 45 | + relates to |
| 46 | +- **O-**prefixed labels specify the OS for issues that are OS-specific |
| 47 | + |
| 48 | +[rust-labels]: https://github.com/rust-lang/rust/blob/master/CONTRIBUTING.md#issue-triage |
| 49 | + |
| 50 | + |
| 51 | +# Pull requests |
| 52 | + |
| 53 | +We use GitHub's pull requests for making changes to nix. |
| 54 | + |
| 55 | +All pull requests are merged via [homu], an integration bot. After the |
| 56 | +pull request has been reviewed, the reviewer will leave a comment like |
| 57 | + |
| 58 | +> @homu r+ |
| 59 | +
|
| 60 | +to let @homu know that it was approved. Then @homu will check that it |
| 61 | +passes tests, and merge if the tests succeed. |
| 62 | + |
| 63 | +[homu]: https://github.com/nix-rust/nix/blob/master/CONVENTIONS.md |
| 64 | + |
| 65 | + |
| 66 | +## API conventions |
| 67 | + |
| 68 | +If you're adding a new API, we have a [document with |
| 69 | +conventions][conventions] to use throughout the nix project. |
| 70 | + |
| 71 | +[conventions]: https://github.com/nix-rust/nix/blob/master/CONVENTIONS.md |
0 commit comments