Contributions to osapi-justfiles are very welcome, but we ask that you read this document before submitting a PR.
- Read the Development guide for prerequisites, setup, and commit message conventions.
- Check existing work — Is there an existing PR? Are there issues discussing the feature/change you want to make? Please make sure you consider/address these discussions in your work.
- Backwards compatibility — Will your change break existing consumers of osapi-justfiles? It is much more likely that your change will be merged if it is backwards compatible. Is there an approach you can take that maintains this compatibility? If not, consider opening an issue first so that changes can be discussed before you invest your time into a PR.
- Documentation — Ensure that you add/update any relevant documentation.
- Testing — Test your changes against a consuming project before submitting.
- Describe your changes — Ensure that you provide a comprehensive description of your changes.
- Issue/PR links — Link any previous work such as related issues or PRs. Please describe how your changes differ to/extend this work.
- Examples — Add any examples or screenshots that you think are useful to demonstrate the effect of your changes.
- Draft PRs — If your changes are incomplete, but you would like to discuss them, open the PR as a draft and add a comment to start a discussion. Using comments rather than the PR description allows the description to be updated later while preserving any discussions.
I want to contribute, where do I start?
All kinds of contributions are welcome, whether it's a typo fix or a shiny new recipe. You can also contribute by upvoting/commenting on issues or helping to answer questions.
I'm stuck, where can I get help?
If you have questions, feel free to open a Discussion on GitHub.