lix-releng-staging/CONTRIBUTING.md

54 lines
2.6 KiB
Markdown
Raw Normal View History

# Contributing to Lix
2023-03-04 16:47:46 +00:00
Welcome and thank you for considering contributing to Lix! We're currently in a soft release phase, and your support means a lot to us.
2023-03-04 16:47:46 +00:00
To ensure a smooth and effective contribution process, here is a summary of our guidelines:
2023-03-04 16:47:46 +00:00
## Getting help?
2023-03-04 16:47:46 +00:00
If you have any question regarding getting started or reporting bugs, feel free
to reach out to us.
2023-03-04 16:47:46 +00:00
On Matrix, we have a space at `#space:lix.systems`, composed of:
2023-03-04 16:47:46 +00:00
- [`#discuss:lix.systems`](https://matrix.to/#/#discuss:lix.systems) for discussions on Lix.
- [`#dev:lix.systems`](https://matrix.to/#/#dev:lix.systems) for the development channel on Lix.
2023-03-04 16:47:46 +00:00
## Report a bug
- Check if your bug has already been reported in the [issue tracker](https://git.lix.systems/lix-project/lix/issues).
- If you can't find the bug or feature, please open a new issue.
2023-03-04 16:47:46 +00:00
We maintain a copy of the upstream Nix bugs. Their organisation can be read about [here](https://wiki.lix.systems/books/lix-contributors/page/bug-tracker-organisation).
2023-03-04 16:47:46 +00:00
## Report a security vulnerability
2023-03-04 16:47:46 +00:00
For security vulnerabilities, reach out by email at `security at lix dot systems`.
2023-03-04 16:47:46 +00:00
## Making changes to Lix
2023-03-04 16:47:46 +00:00
Before diving into making changes, we want to engage with you and your ideas.
2023-03-04 16:47:46 +00:00
We have a few policies in effect; please take the time to familiarize yourself:
2023-07-13 19:57:41 +00:00
- [Style guide on code](https://wiki.lix.systems/books/lix-contributors/page/code)
- [Freeze policy and recommended contributions](https://wiki.lix.systems/books/lix-contributors/page/freezes-and-recommended-contributions)
2023-07-13 19:57:41 +00:00
To avoid duplication of effort, it may be a good idea to check out the list of
[pending pull requests](https://gerrit.lix.systems/q/status:open+-is:wip) (or "change lists", as Gerrit calls them). Once you have
an idea of what you might want to do, we recommend dropping a message on our
Matrix to ensure your contribution fits with our current schedule and plans
2023-03-04 16:47:46 +00:00
When you're ready and your changes are ready to go:
2023-03-04 16:47:46 +00:00
- Submit your code.
- Submitting a GitHub PR [on our mirror](https://github.com/lix-project/lix) is totally ok if that's easier for you and your change is relatively small (300 lines or so).
2023-03-04 16:47:46 +00:00
We may ask you to resubmit it as a Gerrit CL if it is necessary for the change you're making.
- Our primary code review system is [our Gerrit instance](https://gerrit.lix.systems), where you can open a change list (CL).
If you're new to Gerrit, check out [our wiki page about Gerrit](https://wiki.lix.systems/books/lix-contributors/page/gerrit).
- Make sure to link any related issues.
- If needed, indicate that the change is 'work in progress'.
2023-03-04 16:47:46 +00:00
You can obtain an account on our platforms by clicking "Sign In with GitHub" on the sign-in page.