Skip to content

Clarify the flow and scope of usage guides - #2710

Merged
j178 merged 2 commits into
masterfrom
docs-flow
Sep 13, 2026
Merged

j178 merged 2 commits into
masterfrom
docs-flow

Conversation

@j178

@j178 j178 commented Sep 13, 2026

Copy link
Copy Markdown
Owner

Organize configuration, execution, and CI guides around user tasks. Move environment preparation into Running Hooks, consolidate shared guidance, and simplify examples and cross-links.

Copilot AI lite review requested due to automatic review settings September 13, 2026 13:56
@j178 j178 added the documentation Improvements or additions to documentation label Sep 13, 2026
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 13, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-13T14:00:55.538830Z 3da8ab7 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No blocking issues were identified; only a minor documentation anchor-link nit remains.

Pull request overview

Reorganizes usage documentation around configuration, execution, and CI workflows.

Changes:

  • Moves environment preparation guidance into Running Hooks.
  • Consolidates configuration and compatibility guidance.
  • Clarifies examples, built-in hooks, CI usage, and cross-links.
File summaries
File Summary
README.md Updates the automatic fast-path link.
docs/running-hooks.md Adds environment preparation guidance.
docs/reference/workspace.md Updates the configuration precedence link.
docs/quickstart.md Clarifies first-run and hook setup behavior.
docs/local-hooks.md Simplifies filtering guidance.
docs/configuration.md Reorganizes configuration workflow and examples.
docs/compatibility.md Consolidates compatibility guidance; includes a minor anchor-link nit.
docs/ci.md Expands CI, revision-range, and caching guidance.
docs/built-in-hooks.md Clarifies built-in hook behavior and fast paths.
docs/benchmark.md Updates the fast-path link.
Review details

Suppressed comments (1)

docs/compatibility.md:69

  • This link targets #files-exclude, but the reference page defines the explicit anchor as #hook-files-exclude (and the generated heading slug is not this ID), so readers will land on a 404 anchor. Please update the link to the existing hook-filter anchor.
    - [`files` and `exclude` glob mappings](reference/configuration.md#files-exclude)
  • Files reviewed: 10/10 changed files
  • Comments generated: 0
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Copilot AI review requested due to automatic review settings September 13, 2026 14:01

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The reviewed documentation changes have no unresolved blocking issues.

Review details
  • Files reviewed: 10/10 changed files
  • Comments generated: 0 new
  • Review effort level: Lite

@j178
j178 merged commit 57f990b into master Sep 13, 2026
20 checks passed
@j178
j178 deleted the docs-flow branch September 13, 2026 14:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants