Skip to content

Commit

Permalink
Create CONTRIBUTING.md
Browse files Browse the repository at this point in the history
  • Loading branch information
juanmc2005 authored Nov 11, 2023
1 parent 0279f21 commit 2118110
Showing 1 changed file with 58 additions and 0 deletions.
58 changes: 58 additions & 0 deletions CONTRIBUTING.md
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!

0 comments on commit 2118110

Please sign in to comment.