Skip to content

Latest commit

 

History

History
69 lines (43 loc) · 3.62 KB

CONTRIBUTING.md

File metadata and controls

69 lines (43 loc) · 3.62 KB

Contributing to Azimuth 🔭

Thank you for your interest in contributing to Azimuth!

This document should be able to guide contributors in their different types of contributions.

ℹ️ Just want to ask a question? Open a topic on our Discussion page.

Get your environment setup

Azimuth is split in two components. Go to our Setup to get setup on both the frontend and backend.

It is encouraged to be familiar with our development best practices.

When everything is set up, you can refer to the Launching section to launch Azimuth locally or on Docker.

How to submit a bug report

Open an issue on Github and select "Bug report". If you are not sure whether it is a bug or not, submit an issue and we will be able to help you.

Issues with reproducible examples are easier to work with. Do not hesitate to provide your configuration with generated data if need be.

If you are familiar with the codebase, providing a "unit test" is helpful, but not mandatory.

How to submit changes

First, open an issue describing your desired changes, if it does not exist already. This is especially important if you need to add a new dependency. If that is the case, please mention which package and which version you would like to add. Once a team member accepts your proposition, you can start coding!

You can also self-assign an existing issue by commmenting #self-assign on the issue.

  1. Fork the repo to your own account.
  2. Clone your fork of the repo locally.
  3. Make your changes (the fun part).
  4. Commit and push your changes to your fork.
  5. Open a pull-request with your branch.
  6. Once a team member approves your changes, we will merge the pull request promptly.

Guidelines for a good pull-request

When coding, pay special attention to the following:

  • Your code should be well commented for non-trivial sections, so it can be easily understood and maintained by others.
  • Do not expose any personal/sensitive data.
  • Add unit tests when a notable functionality has been added or changed.
  • Read our development best practices to set up pre-commit, and test your changes.
  • Do not forget to notify the team in advance that you are working on an issue (Using #self-assign or by creating an issue). Mention it if you need to add/bump a dependency.
  • Check the PR template in advance to see the checklist of things to do.

Where to ask for help!

If you need help, feel free to reach out to a team member or through a GitHub Discussion. If the team member can't answer your question, they will find someone who can!

Current contributors

We would love to add you to this list!

To reach out to the owners of this project, please see our About page.