Skip to content

chore: monthly docs defragmentation - #266

Open
github-actions[bot] wants to merge 1 commit into
mainfrom
defrag-docs-20260901
Open

github-actions[bot] wants to merge 1 commit into
mainfrom
defrag-docs-20260901

Conversation

@github-actions

@github-actions github-actions Bot commented Sep 1, 2026

Copy link
Copy Markdown
Contributor

Monthly docs defragmentation

Automated review and cleanup of documentation pages.
Each phase is a separate commit for easier review.

Phase 1: Formatting (mechanical)

Trailing newlines, smart quotes, whitespace, code block language tags.
Reviewers can skim this commit.

Phase 1 summary
=== Summary ===
Files changed:   3
Files unchanged: 34

=== Changed files ===
- arcade/starter-packs.md
- services/overview.md
- services/vrng/how-it-works.md

Phase 2: Content (LLM-generated)

Terminology normalization per STYLE_GUIDE.md, deduplication (capped at 10 lines removed per file), cross-reference suggestions.
Review this commit carefully.

Phase 2 summary
=== Summary ===
Files changed:   0
Files unchanged: 0
Files skipped:   0
Files errored:   37

No changes needed — docs are clean!

Phase 3: Link repair (source-validated)

Auto-fixes broken internal links by validating against source files.
Fixes extension removal (.md/.mdx), path corrections, and broken relative links.
Reviewers can skim this commit.

Phase 3 summary
=== Summary ===
Broken links found:    0
Links fixed:           0
TODO markers found:    0
Files modified:        0

All links are valid!

Skipped changes

Files where the LLM suggested removing >10 lines are listed in the workflow output.
These need manual review and may warrant separate issues.

Review notes

  • The build has been verified to pass after all phases
  • Check for [TODO: link to X] markers that need resolution
  • Check for <!-- TODO: deduplicate --> comments flagging large removals
  • Check workflow output for unfixable links that need manual attention

This PR was automatically created by the monthly defragmentation workflow.

Mechanical fixes: trailing newlines, smart quotes,
trailing whitespace, code block language tags.

Found 37 doc files

=== Summary ===
Files changed:   3
Files unchanged: 34

=== Changed files ===
- arcade/starter-packs.md
- services/overview.md
- services/vrng/how-it-works.md
@vercel

vercel Bot commented Sep 1, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Sep 1, 2026 12:48am UTC

Request Review

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.

0 participants