Developer Guide

Contributing

We welcome contributions to Coyote, both for source code as well as documentation. All code should be added via pull requests (PR), targetting the main branch. When opening a PR, please make sure the following steps are followed:

  1. In the PR description, clearly document all changes made. Coyote includes a PR template, which can be used for this purpose.

  2. If adding new functionality, please ensure it works as expeted and add an example/test on how to use it.

  3. Ensure your code is well-commented and documented, with the necessary changes also reflected in Coyote’s documentation.

  4. Be sure to to use the same license for your contributions as the current license of the Coyote component you are contributing to (described below)

Code license: Most of Coyote code is licensed under the terms described in [LICENSE](https://github.com/fpgasystems/Coyote/blob/master/LICENSE.md), which corresponds to the MIT Licence. An exception to this is the Coyote device driver, which is open-sourced with the GPL v2 license. Any contributions to Coyote will be accepted under the same terms of license.

Code reviews: We will aim to review your contribution in a timely manner and, if additional fixes/modifications are needed, provide feedback to guide you. When accepted, your pull request will be merged to the main branch of the repository.

Code of Conduct

In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to make participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.

Examples of behavior that contributes to creating a positive environment include:

  • Using welcoming and inclusive language

  • Being respectful of differing viewpoints and experiences

  • Gracefully accepting constructive criticism

  • Focusing on what is best for the community

  • Showing empathy towards other community members

Attribution: This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html

For answers to common questions about this code of conduct, see https://www.contributor-covenant.org/faq