Thank you for considering contributing to Chat with Your Docs! We appreciate your interest in improving and enhancing our project. By contributing, you can help make Chat with Your Docs even better for all users. Below are the guidelines for contributing to this project.
Before getting started, please read and adhere to our Code of Conduct. We expect all contributors to follow these guidelines to maintain a welcoming and inclusive community.
There are several ways you can contribute to Chat with Your Docs:
-
Reporting Issues: If you encounter any bugs or have suggestions for improvements, please submit an issue on our GitHub Issues page.
-
Fixing Bugs: If you identify a bug and know how to fix it, feel free to submit a pull request with the proposed changes.
-
Adding Features: If you have an idea for a new feature or enhancement, we welcome your contributions. You can submit a pull request with the proposed feature.
-
Documentation: If you notice any areas where the documentation could be improved or clarified, please submit a pull request to update it.
To contribute to Chat with Your Docs, follow these steps:
-
Fork the Repository: Start by forking the Chat with Your Docs repository to your GitHub account.
-
Clone the Repository: Clone the forked repository to your local development environment using the following command:
git clone https://github.com/your-username/Chat-with-Your-Docs.git
-
Create a Branch: Create a new branch for your contribution. Give the branch a descriptive name that reflects the changes you intend to make.
-
Make Changes: Make the necessary changes and improvements in your branch. Ensure that your code adheres to the project's coding style and guidelines.
-
Commit Messages: Write clear and concise commit messages that describe the purpose of each commit. Please follow the standard commit message format:
type(scope): commit message
For example:
feat(search): Add fuzzy search feature
fix(bug): Fix issue with search results
The allowed commit types are:
feat
: For new features or enhancementsfix
: For bug fixeschore
: For maintenance tasks or other non-functional changesdocs
: For documentation updatesstyle
: For code style changes (e.g., formatting, whitespace)refactor
: For code refactoring or restructuringtest
: For adding or updating tests
-
Testing: If applicable, ensure that your changes include appropriate tests and that all existing tests pass. (Testing suite coming soon)
-
Push Changes: Push your changes to your forked repository.
-
Submit Pull Request: Once your changes are ready, submit a pull request from your branch to the main repository's
main
branch. Provide a clear description of your changes in the pull request. -
Code Review: Your pull request will be reviewed by the maintainers. Address any feedback or comments as necessary.
-
Merge: Once your pull request is approved, it will be merged into the main repository.
By contributing to Chat with Your Docs, you agree that your contributions will be licensed under the MIT License.
Thank you for contributing to Chat with Your Docs! Your efforts help make this project better for everyone.