Skip to content

Latest commit

 

History

History
52 lines (34 loc) · 2.8 KB

CONTRIBUTING.md

File metadata and controls

52 lines (34 loc) · 2.8 KB

Table of contents

Contributing Guidelines

Thank you for your interest in contributing to our project. Whether it's a bug report, new feature, correction, or additional documentation, we greatly value feedback and contributions from our community.

Please read through this document before submitting any issues or pull requests to ensure we have all the necessary information to effectively respond to your bug report or contribution.

Reporting Bugs/Feature Requests

We welcome you to use the GitHub issue tracker to report bugs, suggest features, or documentation improvements.

When filing an issue, please check existing open, or recently closed, issues to make sure somebody else hasn't already reported the issue. Please try to include as much information as you can.

Contributing via Pull Requests

Contributions via pull requests are much appreciated. Before sending us a pull request, please ensure that:

  1. You are working against the latest source on the main branch.
  2. You check existing open, and recently merged pull requests to make sure someone else hasn't addressed the problem already.
  3. You open an issue before you begin any implementation. We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

Dev setup

Gitpod Ready-to-Code

Firstly, fork the repository.

use make dev within your local virtual environment. For more information on getting started check out the official documentation

To send us a pull request, please follow these steps:

  1. Create a new branch to focus on the specific change you are contributing e.g. improve/service_logic
  2. Run all tests, and code baseline checks: make pr
    • Git hooks will run linting and formatting while make pr run deep checks that also run in the CI process
  3. Commit to your fork using clear commit messages.
  4. Open an issue in the repository and wait for feedback. We will to respond within a few days, please be patient.
  5. Once the issue is agreed to be implemented, open a PR.

GitHub provides additional document on forking a repository and creating a pull request.