-
Notifications
You must be signed in to change notification settings - Fork 770
Add contributor and maintainer guides #239
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull Request Overview
This PR adds comprehensive documentation for contributors and maintainers by introducing a "Community" section to the documentation site. The documentation covers environment setup, development workflows, release procedures, and CI/CD interactions.
- Adds Contributing Guide covering environment setup, pre-commit hooks, branching workflows, and pull request guidelines
- Adds Maintainer Guide documenting release processes, CI label usage, and backporting procedures
- Updates README.md to reference the new Contributing Guide
Reviewed Changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| mkdocs.yml | Adds Community navigation section with Contributing Guide and Maintainer Guide links |
| docs/community/contributing.md | New contributor documentation detailing environment setup, development workflow, and PR submission process |
| docs/community/maintainers.md | New maintainer documentation covering release workflow, CI labels, and backport procedures |
| README.md | Updates contributing section to reference the new Contributing Guide documentation |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
docs/community/maintainers.md
Outdated
| 4. **Update release collateral** | ||
| - Ensure the examples catalog at `examples/README.md` accurately reflects maintenance status and CI badges. | ||
| - Review the API reference pages in `docs/reference/` for outdated signatures or docstrings. | ||
| - Draft release notes in `docs/releases/` (create a new file for the version if necessary) and summarize key changes. Copy the same content into the GitHub release body later. |
Copilot
AI
Oct 29, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The docs/releases/ directory does not exist in the repository. This instruction should either be updated to reflect the actual location for release notes or the directory should be created as part of this PR.
| - Draft release notes in `docs/releases/` (create a new file for the version if necessary) and summarize key changes. Copy the same content into the GitHub release body later. | |
| - Draft release notes in `docs/releases/` (create the directory and a new file for the version if necessary) and summarize key changes. Copy the same content into the GitHub release body later. |
…x/add-contribution-and-maintainer-guides
Summary
Testing
uv run mkdocs build --strict(fails locally: git metadata plugins warn about newly added pages; succeeds once merged)https://chatgpt.com/codex/tasks/task_e_69008739d37c832eb4faaec6e0092b8b