Skip to content

Conversation

@ultmaster
Copy link
Contributor

Summary

  • add a contributor guide detailing environment setup, branching conventions, and PR expectations
  • document the maintainer release workflow, CI label usage, and backport process
  • surface both guides in the documentation navigation and link the README to the contributor guide

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

Copilot AI review requested due to automatic review settings October 29, 2025 03:11
Copy link
Contributor

Copilot AI left a 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.

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.
Copy link

Copilot AI Oct 29, 2025

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.

Suggested change
- 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.

Copilot uses AI. Check for mistakes.
@ultmaster ultmaster merged commit 4cd09ec into main Nov 1, 2025
12 checks passed
totoluo pushed a commit to totoluo/agent-lightning that referenced this pull request Nov 14, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants