Skip to content

docs: regenerate stale tables of contents - #968

Merged
aparajon merged 1 commit into
mainfrom
docs/regenerate-stale-tocs
Aug 13, 2026
Merged

docs: regenerate stale tables of contents#968
aparajon merged 1 commit into
mainfrom
docs/regenerate-stale-tocs

Conversation

@aparajon

@aparajon aparajon commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Why this matters: make docs-toc produced uncommitted diffs on a clean checkout of main, so anyone touching an unrelated doc would pick up these TOC changes as noise in their own PR.

What it does: Regenerates the auto-generated TOC blocks. Three docs (configuration, github-app-setup, grpc-control-edge-cases) had entries missing for sections added after their TOC was last generated; three docs (storage-outage-behavior, strata-engine, apply-lifecycle) had no TOC block at all. Insertions only, all inside the BEGIN TOC/END TOC markers — no prose or heading changes.

🤖 Generated with Claude Code

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings August 7, 2026 20:02
@aparajon
aparajon marked this pull request as ready for review August 7, 2026 20:04

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.

Pull request overview

Regenerates and inserts/upgrades the auto-generated make docs-toc Table of Contents blocks across several documentation pages so a clean checkout of main no longer produces TOC-only diffs.

Changes:

  • Added missing auto-generated TOC blocks to docs that previously had none.
  • Updated existing TOC blocks to include headings that were added after the last TOC generation.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file
File Description
docs/strata-engine.md Adds a missing auto-generated TOC block for the Strata engine doc.
docs/storage-outage-behavior.md Adds a missing auto-generated TOC block for storage outage behavior doc.
docs/grpc-control-edge-cases.md Updates existing TOC to include newly added edge-case/recovery sections.
docs/github-app-setup.md Updates existing TOC to include the new “Repository-level Webhooks (optional)” section.
docs/configuration.md Updates existing TOC to include new configuration subsections.
docs/apply-lifecycle.md Adds a missing auto-generated TOC block for apply lifecycle/recovery doc.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@morgo morgo left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

🤖 Approved by Morgan's AI agent (low-risk review pass): docs-only — regenerated make docs-toc TOC blocks across 6 docs files, no content changes beyond the TOC markers. Full CI green.

@aparajon
aparajon merged commit b50dac0 into main Aug 13, 2026
33 checks passed
@aparajon
aparajon deleted the docs/regenerate-stale-tocs branch August 13, 2026 07:21
Kiran01bm added a commit that referenced this pull request Aug 13, 2026
…re-public-13n

* origin/main:
  refactor(storage): portable lease-guarded joined DML for the operation store (#1011)
  fix(github): align lint warnings formatting with issues and fold long lists (#959)
  fix(github): lead with the database's operators on command-rejection comments (#960)
  docs: regenerate stale tables of contents (#968)
  fix(engine): heartbeat the row a local drive actually owns (#915)
  fix(github): scope auto-plan to the schema a pull request proposes (#1016)
  fix(vitess): dispatch task-less VSchema-only work operations over gRPC (#961)
  feat(storage): add PostgreSQL dialect nucleus to the shared store core (#1010)
  refactor(storage): render joined UPDATEs through the dialect (#1009)
  fix(planetscale): hold the cutover when the operator defers it (#978)
  fix(observability): make telemetry resource schema-tolerant (#1014)
  feat(postgres): implement declarative planning via pg-sprite diffplan (#1008)
  refactor(storage): make remaining sqlstore SQL dialect-portable (#1007)
  test(e2e): deflake multi-table stop/start resume and MySQL cold starts (#1005)
  ci: verify golangci config against a vendored schema (#997)
  feat(api): fail-closed verdict gating for postgres plans (#1004)
  feat(tern): route postgres targets to the postgres engine (#1003)
  feat(storage): stamp remaining sqlstore timestamps explicitly (#1006)
Kiran01bm added a commit that referenced this pull request Aug 13, 2026
…lect-factory-14b

* origin/main:
  feat(github): flag destructive changes to tables another open PR owns (#1017)
  feat(storage): add public postgresstore constructor (#1012)
  refactor(storage): portable lease-guarded joined DML for the operation store (#1011)
  fix(github): align lint warnings formatting with issues and fold long lists (#959)
  fix(github): lead with the database's operators on command-rejection comments (#960)
  docs: regenerate stale tables of contents (#968)
  fix(engine): heartbeat the row a local drive actually owns (#915)
  fix(github): scope auto-plan to the schema a pull request proposes (#1016)
  fix(vitess): dispatch task-less VSchema-only work operations over gRPC (#961)
  feat(storage): add PostgreSQL dialect nucleus to the shared store core (#1010)
  refactor(storage): render joined UPDATEs through the dialect (#1009)
  fix(planetscale): hold the cutover when the operator defers it (#978)
  fix(observability): make telemetry resource schema-tolerant (#1014)
  feat(postgres): implement declarative planning via pg-sprite diffplan (#1008)
  refactor(storage): make remaining sqlstore SQL dialect-portable (#1007)
  test(e2e): deflake multi-table stop/start resume and MySQL cold starts (#1005)
  ci: verify golangci config against a vendored schema (#997)
  feat(api): fail-closed verdict gating for postgres plans (#1004)
  feat(tern): route postgres targets to the postgres engine (#1003)
  feat(storage): stamp remaining sqlstore timestamps explicitly (#1006)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants