First off, thanks for taking the time to contribute! 🎉 👍
The following is a set of guidelines for contributing to CleanGraph, an open-source project hosted on GitHub. These are mostly guidelines, not rules. Use your best judgement, and feel free to propose changes to this document in a pull request.
This project and everyone participating in it are governed by the CleanGraph Code of Conduct. By participating, you are expected to uphold this code.
We use GitHub issues to track public bugs and features. Issue tracking is for problems with the software, not a place to ask how to use it. If you are having difficulty after looking over your configuration carefully, please post a question to StackOverflow.
- If you find a bug, use the GitHub issues search feature to see if it has already been reported. If it has not, please open a new issue.
- If you have a feature request, it is wise to ensure that it aligns with the project goals. Please start by opening a new issue. Be sure to include a clear title and detailed description and be as transparent as possible.
We actively welcome your pull requests:
- Fork the repo and create your branch from
main
. - If you've added code that should be tested, add tests.
- If you've changed APIs, update the documentation.
- Ensure the test suite passes.
- Make sure your code lints.
- Issue that pull request!
- Use the present tense ("Add feature" not "Added feature").
- Use the imperative mood ("Move cursor to..." not "Moves cursor to...").
- Limit the first line to 72 characters or less.
- Reference issues and pull requests liberally after the first line.
All Python code must adhere to the PEP 8 Style Guide for Python Code.
All JavaScript must adhere to the JavaScript Standard Style.
This section lists the labels we use to help us track and manage issues and pull requests.
Label name | Description |
---|---|
bug |
Confirmed issues or issues that are very likely bugs. |
enhancement |
Feature requests. |
docs |
Changes to documentation. |
duplicate |
Issues which are duplicates of other issues, i.e., they have been reported before. |
question |
Questions more than bug reports or feature requests (e.g. how do I do X). |
Thank you for your interest in contributing to CleanGraph!