-
-
Notifications
You must be signed in to change notification settings - Fork 1.5k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
492 changed files
with
15,163 additions
and
6,642 deletions.
There are no files selected for viewing
Validating CODEOWNERS rules …
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
# Pull requests concerning the listed files will automatically invite the respective maintainers as reviewers. | ||
# This file is not used for denoting any kind of ownership, but is merely a tool for handling notifications. | ||
# | ||
# Merge permissions are required for maintaining an entry in this file. | ||
# For documentation on this mechanism, see https://help.github.com/articles/about-codeowners/ | ||
|
||
# Default reviewers if nothing else matches | ||
* @edolstra | ||
|
||
# This file | ||
.github/CODEOWNERS @edolstra | ||
|
||
# Public documentation | ||
/doc @fricklerhandwerk | ||
*.md @fricklerhandwerk | ||
|
||
# Libstore layer | ||
/src/libstore @thufschmitt |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,36 @@ | ||
--- | ||
name: Installer issue | ||
about: Report problems with installation | ||
title: '' | ||
labels: installer | ||
assignees: '' | ||
|
||
--- | ||
|
||
## Platform | ||
|
||
<!-- select the platform on which you tried to install Nix --> | ||
|
||
- [ ] Linux: <!-- state your distribution, e.g. Arch Linux, Ubuntu, ... --> | ||
- [ ] macOS | ||
- [ ] WSL | ||
|
||
## Additional information | ||
|
||
<!-- state special circumstances on your system or additional steps you have taken prior to installation --> | ||
|
||
## Output | ||
|
||
<details><summary>Output</summary> | ||
|
||
```log | ||
<!-- paste console output here and remove this comment --> | ||
``` | ||
|
||
</details> | ||
|
||
## Priorities | ||
|
||
Add :+1: to [issues you find important](https://github.com/NixOS/nix/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,32 @@ | ||
# Motivation | ||
<!-- Briefly explain what the change is about and why it is desirable. --> | ||
|
||
# Context | ||
<!-- Provide context. Reference open issues if available. --> | ||
|
||
<!-- Non-trivial change: Briefly outline the implementation strategy. --> | ||
|
||
<!-- Invasive change: Discuss alternative designs or approaches you considered. --> | ||
|
||
<!-- Large change: Provide instructions to reviewers how to read the diff. --> | ||
|
||
# Checklist for maintainers | ||
|
||
<!-- Contributors: please leave this as is --> | ||
|
||
Maintainers: tick if completed or explain if not relevant | ||
|
||
- [ ] agreed on idea | ||
- [ ] agreed on implementation strategy | ||
- [ ] tests, as appropriate | ||
- functional tests - `tests/**.sh` | ||
- unit tests - `src/*/tests` | ||
- integration tests - `tests/nixos/*` | ||
- [ ] documentation in the manual | ||
- [ ] code and comments are self-explanatory | ||
- [ ] commit message explains why the change was made | ||
- [ ] new feature or incompatible change: updated release notes | ||
|
||
# Priorities | ||
|
||
Add :+1: to [pull requests you find important](https://github.com/NixOS/nix/pulls?q=is%3Aopen+sort%3Areactions-%2B1-desc). |
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
"documentation": | ||
- doc/manual/* | ||
- src/nix/**/*.md | ||
|
||
"tests": | ||
- tests/**/* |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
name: "Label PR" | ||
|
||
on: | ||
pull_request_target: | ||
types: [edited, opened, synchronize, reopened] | ||
|
||
# WARNING: | ||
# When extending this action, be aware that $GITHUB_TOKEN allows some write | ||
# access to the GitHub API. This means that it should not evaluate user input in | ||
# a way that allows code injection. | ||
|
||
permissions: | ||
contents: read | ||
pull-requests: write | ||
|
||
jobs: | ||
labels: | ||
runs-on: ubuntu-latest | ||
if: github.repository_owner == 'NixOS' | ||
steps: | ||
- uses: actions/labeler@v4 | ||
with: | ||
repo-token: ${{ secrets.GITHUB_TOKEN }} | ||
sync-labels: true |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1 @@ | ||
2.12.0 | ||
2.15.0 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,61 @@ | ||
# Contributing to Nix | ||
|
||
Welcome and thank you for your interest in contributing to Nix! | ||
We appreciate your support. | ||
|
||
Reading and following these guidelines will help us make the contribution process easy and effective for everyone involved. | ||
|
||
|
||
## Report a bug | ||
|
||
1. Check on the [GitHub issue tracker](https://github.com/NixOS/nix/issues) if your bug was already reported. | ||
|
||
2. If you were not able to find the bug or feature [open a new issue](https://github.com/NixOS/nix/issues/new/choose) | ||
|
||
3. The issue templates will guide you in specifying your issue. | ||
The more complete the information you provide, the more likely it can be found by others and the more useful it is in the future. | ||
Make sure reported bugs can be reproduced easily. | ||
|
||
4. Once submitted, do not expect issues to be picked up or solved right away. | ||
The only way to ensure this, is to [work on the issue yourself](#making-changes-to-nix). | ||
|
||
## Report a security vulnerability | ||
|
||
Check out the [security policy](https://github.com/NixOS/nix/security/policy). | ||
|
||
## Making changes to Nix | ||
|
||
1. Check for [pull requests](https://github.com/NixOS/nix/pulls) that might already cover the contribution you are about to make. | ||
There are many open pull requests that might already do what you intent to work on. | ||
You can use [labels](https://github.com/NixOS/nix/labels) to filter for relevant topics. | ||
|
||
2. Search for related issues that cover what you're going to work on. It could help to mention there that you will work on the issue. | ||
|
||
3. Check the [Nix reference manual](https://nixos.org/manual/nix/unstable/contributing/hacking.html) for information on building Nix and running its tests. | ||
|
||
For contributions to the command line interface, please check the [CLI guidelines](https://nixos.org/manual/nix/unstable/contributing/cli-guideline.html). | ||
|
||
4. Make your changes! | ||
|
||
5. [Create a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) for your changes. | ||
* [Mark the pull request as draft](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/changing-the-stage-of-a-pull-request) if you're not done with the changes. | ||
* Make sure to have [a clean history of commits on your branch by using rebase](https://www.digitalocean.com/community/tutorials/how-to-rebase-and-update-a-pull-request). | ||
* Link related issues in your pull request to inform interested parties and future contributors about your change. | ||
If your pull request closes one or multiple issues, note that in the description using `Closes: #<number>`, as it will then happen automatically when your change is merged. | ||
|
||
6. Do not expect your pull request to be reviewed immediately. | ||
Nix maintainers follow a [structured process for reviews and design decisions](https://github.com/NixOS/nix/tree/master/maintainers#project-board-protocol), which may or may not prioritise your work. | ||
|
||
7. If you need additional feedback or help to getting pull request into shape, ask other contributors using [@mentions](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#mentioning-people-and-teams). | ||
|
||
## Making changes to the Nix manual | ||
|
||
The Nix reference manual is hosted on https://nixos.org/manual/nix. | ||
The underlying source files are located in [`doc/manual/src`](./doc/manual/src). | ||
For small changes you can [use GitHub to edit these files](https://docs.github.com/en/repositories/working-with-files/managing-files/editing-files) | ||
For larger changes see the [Nix reference manual](https://nixos.org/manual/nix/unstable/contributing/hacking.html). | ||
|
||
## Getting help | ||
|
||
Whenever you're stuck or do not know how to proceed, you can always ask for help. | ||
The appropriate channels to do so can be found on the [NixOS Community](https://nixos.org/community/) page. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.