Skip to content

chore: monthly docs defragmentation - #259

Open
github-actions[bot] wants to merge 3 commits into
mainfrom
defrag-docs-20260501
Open

github-actions[bot] wants to merge 3 commits into
mainfrom
defrag-docs-20260501

Conversation

@github-actions

@github-actions github-actions Bot commented May 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:   26
Files unchanged: 10
Files skipped:   1
Files errored:   0

=== Changed files ===
- arcade/marketplace.md
- arcade/overview.md
- arcade/setup.md
- controller/achievements.md
- controller/booster-packs.md
- controller/configuration.md
- controller/examples/cli.md
- controller/examples/node.md
- controller/examples/react.md
- controller/examples/rust.md
- controller/examples/svelte.md
- controller/getting-started.mdx
- controller/headless-authentication.md
- controller/native/android.md
- controller/native/capacitor.md
- controller/native/ios.md
- controller/native/overview.md
- controller/native/react-native.md
- controller/native/session-flow.md
- controller/signer-management.md
- controller/starter-packs.md
- controller/toast-notifications.md
- controller/usernames.md
- services/paymaster.md
- services/vrng/how-it-works.md
- services/vrng/index.md

=== Skipped files (large removals — needs manual review) ===
- controller/sessions.md (13 net lines removed)

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:    1
Links fixed:           1
TODO markers found:    1
Files modified:        1

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.

github-actions Bot added 3 commits May 1, 2026 00:54
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
Terminology normalization, deduplication, cross-reference
suggestions. Changes capped at 10 net removed lines per file.

- controller/examples/rust.md
- controller/examples/svelte.md
- controller/getting-started.mdx
- controller/headless-authentication.md
- controller/native/android.md
- controller/native/capacitor.md
- controller/native/ios.md
- controller/native/overview.md
- controller/native/react-native.md
- controller/native/session-flow.md
- controller/signer-management.md
- controller/starter-packs.md
- controller/toast-notifications.md
- controller/usernames.md
- services/paymaster.md
- services/vrng/how-it-works.md
- services/vrng/index.md

=== Skipped files (large removals — needs manual review) ===
- controller/sessions.md (13 net lines removed)
Auto-fixed broken internal links validated against source files.
Extension removals, path corrections, broken anchor cleanup.

=== Phase 3: Link Repair ===
Mode: LIVE

Found 37 source files
No build output found — validating against source files (anchor checks may be approximate)
Found 37 pages from source files

  controller/examples/react.md:358 — page not found: ./sessions → /controller/sessions
  services/paymaster.md:166 — TODO unresolved: vRNG overview

=== Summary ===
Broken links found:    1
Links fixed:           1
TODO markers found:    1
Files modified:        1
@vercel

vercel Bot commented May 1, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview May 1, 2026 1:18am

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