-
-
Notifications
You must be signed in to change notification settings - Fork 91
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
0279f21
commit 2118110
Showing
1 changed file
with
58 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,58 @@ | ||
# Contributing to diart | ||
|
||
Thank you for considering contributing to diart! We appreciate your time and effort to help make this project better. | ||
|
||
## Before You Start | ||
|
||
1. **Search for Existing Issues or Discussions:** | ||
- Before opening a new issue or discussion, please check if there's already an existing one related to your topic. This helps avoid duplicates and keeps discussions centralized. | ||
|
||
2. **Discuss Your Contribution:** | ||
- If you plan to make a significant change, it's advisable to discuss it in an issue first. This ensures that your contribution aligns with the project's goals and avoids duplicated efforts. | ||
|
||
3. **Questions about diart:** | ||
- For general questions about diart, use the discussion space on GitHub. This helps in fostering a collaborative environment and encourages knowledge-sharing. | ||
|
||
## Opening Issues | ||
|
||
If you encounter a problem with diart or want to suggest an improvement, please follow these guidelines when opening an issue: | ||
|
||
- **Bug Reports:** | ||
- Clearly describe the error, including any relevant stack traces. | ||
- Provide a minimal, reproducible example that demonstrates the issue. | ||
- Mention the version of diart you are using (as well as any dependencies related to the bug). | ||
|
||
- **Feature Requests:** | ||
- Clearly outline the new feature you are proposing. | ||
- Explain how it would benefit the project. | ||
|
||
## Opening Pull Requests | ||
|
||
We welcome and appreciate contributions! To ensure a smooth review process, please follow these guidelines when opening a pull request: | ||
|
||
- **Create a Branch:** | ||
- Work on your changes in a dedicated branch created from `develop`. | ||
|
||
- **Commit Messages:** | ||
- Write clear and concise commit messages, explaining the purpose of each change. | ||
|
||
- **Documentation:** | ||
- Update documentation when introducing new features or making changes that impact existing functionality. | ||
|
||
- **Tests:** | ||
- If applicable, add or update tests to cover your changes. | ||
|
||
- **Code Style:** | ||
- Follow the existing coding style of the project. We use `black` and `isort`. | ||
|
||
- **Discuss Before Major Changes:** | ||
- If your PR includes significant changes, discuss it in an issue first. | ||
|
||
- **Follow the existing workflow:** | ||
- Make sure to open your PR against `develop` (**not** `main`). | ||
|
||
## Thank You | ||
|
||
Your contributions make diart better for everyone. Thank you for your time and dedication! | ||
|
||
Happy coding! |