distribution/CONTRIBUTING.md

40 lines
2.4 KiB
Markdown
Raw Normal View History

2022-02-13 13:19:58 +00:00
# Contributing to JELOS
2022-04-17 12:17:59 +00:00
Welcome new contributor! Your contribution will help JELOS become a better Linux distribution, so thank you! We want to make contributing to this project as easy and transparent as possible. Contributors are able to:
2022-02-13 13:19:58 +00:00
- Discuss the current state of the code
- Submit a fix
- Propose new features
- Become a maintainer
## Becoming a maintainer
When contributing to JELOS you are expected to become the maintainer of your contribution. Please keep this in mind when submitting pull requests.
* Keep track of your contributions upstreams and keep your components up-to-date.
* Watch the issue tracker and resolve issues related to your contribution.
## We Develop with Github
2022-04-17 12:17:59 +00:00
We use Github to host code, to track issues and feature requests, as well as accept pull requests.
2022-02-13 13:19:58 +00:00
## We Use [Github Flow](https://guides.github.com/introduction/flow/index.html), So All Code Changes Happen Through Pull Requests
Pull requests are the best way to propose changes to the codebase (we use [Github Flow](https://guides.github.com/introduction/flow/index.html)). We actively welcome your pull requests:
2022-05-11 11:31:51 +00:00
1. Join our discord and chat with us, we'll be happy to help you successfully implement your change.
2022-04-17 12:17:59 +00:00
2. Fork the repo and create your branch from `dev`.
3. Ensure your code is built locally and tested.
4. Any changes should be reflected in the documentation.
5. Issue a pull request back to our `dev` branch.
2022-02-13 13:19:58 +00:00
## Any contributions you make will be under the Apache 2 Software License
In short, when you submit code changes, your submissions are understood to be contributed under the same license as the original project code or under [Apache 2](https://choosealicense.com/licenses/apache-2.0/) license when no other license applies.
## Use a Consistent Coding Style
* Follow the same style as the source you are editing.
* If you are contributing new code, keep the style consistent with other similar works.
* Parameterize as much as possible, try to avoid hard coded values whenever you can.
* Use 2 spaces for indentation rather than tabs when possible.
## License
By contributing, you agree that your contributions will be licensed under the license of the existing project code being modified or Apache 2.
## References
This document was adapted from the open-source contribution guidelines for [Facebook's Draft](https://github.com/facebook/draft-js/blob/a9316a723f9e918afde44dea68b5f9f39b7d9b00/CONTRIBUTING.md)