Skip to content

Commit b559dd5

Browse files
committed
Add a document with contribution guidelines
1 parent 7fa7206 commit b559dd5

File tree

1 file changed

+71
-0
lines changed

1 file changed

+71
-0
lines changed

CONTRIBUTING.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
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

Comments
 (0)