Thank you for your interest in contributing to Dynamiq! We welcome contributions in various forms, including bug reports, feature requests, documentation improvements, and code contributions.
If you find a bug, please open an issue on our GitHub repository. Provide as much information as possible, including:
- A clear and descriptive title.
- Steps to reproduce the bug.
- Expected and actual behavior.
- Screenshots, logs, or code snippets, if applicable.
If you have an idea for a new feature or an improvement, please open an issue with the following details:
- A clear and descriptive title.
- A detailed description of the feature.
- Any relevant use cases or examples.
Good documentation is key to a successful project. If you find areas in our documentation that need improvement, feel free to submit a pull request. Here are some ways you can help:
- Fix typos or grammatical errors.
- Clarify confusing sections.
- Add missing information.
-
Fork the Repository: Fork the repository to your own GitHub account.
-
Clone the Fork: Clone your fork to your local machine:
git clone https://github.com/YOUR-USERNAME/dynamiq
-
Create a virtaul environment and install project requirements:
make install
-
Create a Branch: Create a new branch for your work:
git checkout -b feature-name
-
Make Changes: Make your changes in your branch.
-
Write Tests: If applicable, write tests for your changes.
-
Commit Changes: Commit your changes with a descriptive commit message:
git commit -m "Description of the feature or fix"
-
Make sure you run tests before pushing your changes:
make prepare test
-
Push to Fork: Push your changes to your forked repository:
git push origin feature-name
-
Open a Pull Request: Open a pull request from your fork to the main repository. Include a detailed description of your changes and any related issues.
Please follow the code style used in the project. We use PEP 8 for Python code. Ensure your code passes all linting checks before submitting a pull request.
All pull requests will be reviewed by our maintainers. We aim to provide feedback within a few days. Please be responsive to any feedback or questions and be ready to make changes if necessary.