Thank you for your interest in Guillaume. This guide explains how to contribute with consistent quality and collaboration practices.
Project Principles
- Keep code quality high.
- Prefer clear and maintainable implementations.
- Document non-trivial behavior.
- Respect contributors and review feedback.
Before You Start
Pull Request Workflow
- Fork the repository.
- Create a dedicated branch.
- Implement your changes.
- Add or update tests.
- Run the test suite.
- Open a pull request.
Ensure your code matches conventions and passes tests before requesting review.
Issue Guidelines
Use the provided issue templates and include enough context:
- Clear and descriptive title.
- Detailed description.
- Reproduction steps when relevant.
- Logs, screenshots, or traces when useful.
Please avoid:
- Duplicate issues.
- Off-topic requests.
- Inappropriate language.
- Disrespectful behavior.
- Incomplete reports that ignore templates.
Documentation Guidelines
Guillaume uses Doxygen for API documentation.
- Document public classes, functions, and modules.
- Keep descriptions concise and accurate.
- Use proper tags such as
@param and @return.
- Update comments when behavior changes.
AI-assisted documentation is acceptable, but review and edit generated text before submitting.
Code Of Conduct
This project follows the Contributor Covenant.
For unacceptable behavior, contact: