First off, thank you for considering contributing to Charwiki! Your help is greatly appreciated.
The following is a set of guidelines for contributing to Charwiki on GitHub. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
If you find a bug in the source code or a mistake in the documentation, you can help us by submitting an issue to our GitHub Repository. After that, you can submit a Pull Request with a fix.
When filing an issue, please include:
- A clear and descriptive title.
- A detailed description of the problem and steps to reproduce it.
- Any relevant log files, error messages, or screenshots.
-
Fork the Repo: Create a personal fork of the repository on GitHub.
-
Clone the Forked Repo: Clone your forked repository to your local machine.
git clone https://github.com/je-sendra/Charwiki.git
-
Create a Branch: Create a new branch for your feature or bugfix.
git checkout -b feature/your-feature-name
-
Make Changes: Make your changes to the codebase.
-
Commit Changes: Commit your changes with a clear message, please follow the Conventional Commits specification.
git commit -m "Description of the changes"
-
Push Changes: Push your changes to your forked repository.
git push origin feature/your-feature-name
-
Create Pull Request: Create a pull request to merge your changes into the main repository. Please include:
- A clear title and description of your changes.
- A reference to the issue your pull request addresses (if applicable).
To keep the codebase clean and maintainable, please adhere to the following guidelines:
- Follow the coding style and conventions used in the project.
- Write clear, concise, and descriptive commit messages, please adhere to the Conventional Commits specification.
- Ensure your code is well-documented and comments are included where necessary.
- Write tests for new features and bug fixes, and ensure all tests pass before submitting a pull request.
Please see the docs/contributing folder for more details on the coding style and conventions, and contributing guidelines used in the project.
We expect all contributors to adhere to our Code of Conduct. Please read it to understand the expected behavior when interacting in the project.
By contributing to Charwiki, you agree that your contributions will be licensed under the AGPL v3 License.