Reticulum/Contributing.md

41 lines
2.9 KiB
Markdown
Raw Normal View History

2023-02-09 15:18:59 +00:00
# Contributing to Reticulum
Welcome, and thank you for your interest in contributing to Reticulum!
2023-12-30 16:34:51 +00:00
Apart from writing code, there are many ways in which you can contribute. Before interacting with this community, read these short and simple guidelines.
## Expected Conduct
First and foremost, there is one simple requirement for taking part in this community: While we primarily interact virtually, your actions matter and have real consequences. Therefore: **Act like a responsible, civilized person** - also in the face of disputes and heated disagreements. Speak your mind here, discussions are welcome. Just do so in the spirit of being face-to-face with everyone else. Thank you.
2023-02-09 15:18:59 +00:00
## Asking Questions
2023-12-30 16:34:51 +00:00
If you want to ask a question, **do not open an issue**. The issue tracker is used by people *working on Reticulum* to track bugs, issues and improvements.
2023-02-09 15:18:59 +00:00
2024-01-03 11:00:10 +00:00
Instead, ask away on the [discussions](https://github.com/markqvist/Reticulum/discussions) or on the [Reticulum Matrix channel](https://matrix.to/#/#reticulum:matrix.org) at `#reticulum:matrix.org`
2023-02-09 15:18:59 +00:00
2023-12-30 16:34:51 +00:00
## Providing Feedback & Ideas
2024-01-03 11:00:10 +00:00
Likewise, feedback, ideas and feature requests are a very welcome way to contribute, and should also be posted on the [discussions](https://github.com/markqvist/Reticulum/discussions), or on the [Reticulum Matrix channel](https://matrix.to/#/#reticulum:matrix.org) at `#reticulum:matrix.org`.
2023-02-09 15:18:59 +00:00
2023-12-30 16:34:51 +00:00
Please do not post feature requests or general ideas on the issue tracker, or in direct messages to the primary developers. You are much more likely to get a response and start a constructive discussion by posting your ideas in the public channels created for these purposes.
2023-02-09 15:18:59 +00:00
## Reporting Issues
2023-12-30 20:43:35 +00:00
If you have found a bug or issue in this project, please report it using the [issue tracker](https://github.com/markqvist/Reticulum/issues). If at all possible, be sure to include details on how to reproduce the bug.
Anything submitted to the issue tracker that does not follow these guidelines will be closed and removed without comments or explanation.
2023-02-09 15:18:59 +00:00
## Writing Code
2024-03-10 19:39:49 +00:00
If you are interested in contributing code, fixing open issues or adding features, please coordinate the effort with the maintainer or one of the main developers **before** submitting a pull request. Before deciding to contribute, it is also a good idea to ensure your efforts are in alignment with the [Roadmap](./Roadmap.md) and current development focus.
2024-03-10 21:11:44 +00:00
Pull requests have a high chance of being accepted if they are:
- In alignment with the [Roadmap](./Roadmap.md) or solve an open issue or feature request
- Sufficiently tested to work with all API functions, and pass the standard test suite
- Functionally and conceptually complete and well-designed
- Well-documented
Even new ideas and proposals that have not been approved by a maintainer, or fall outside the established roadmap, are *occasionally* accepted - if they possess the remaining of the above qualities. If not, they will be closed and removed without comments or explanation.