Skip to content

chore: monthly docs defragmentation#263

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

chore: monthly docs defragmentation#263
github-actions[bot] wants to merge 3 commits into
mainfrom
defrag-docs-20260601

Conversation

@github-actions

@github-actions github-actions Bot commented Jun 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:   30
Files unchanged: 6
Files skipped:   1
Files errored:   0

=== Changed files ===
- arcade/marketplace.md
- arcade/overview.md
- arcade/setup.md
- controller/achievements.md
- controller/architecture.md
- controller/booster-packs.md
- controller/coinbase-onramp.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/inventory.md
- controller/native/android.md
- controller/native/capacitor.md
- controller/native/headless.md
- controller/native/ios.md
- controller/native/overview.md
- controller/native/react-native.md
- controller/native/session-flow.md
- controller/presets.md
- controller/sessions.md
- controller/signer-management.md
- controller/starter-packs.md
- controller/toast-notifications.md
- controller/usernames.md
- services/vrng/how-it-works.md
- services/vrng/index.md

=== Skipped files (large removals — needs manual review) ===
- controller/configuration.md (124 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:    2
Links fixed:           3
TODO markers found:    1
Files modified:        2

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 June 1, 2026 01:05
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/headless-authentication.md
- controller/inventory.md
- controller/native/android.md
- controller/native/capacitor.md
- controller/native/headless.md
- controller/native/ios.md
- controller/native/overview.md
- controller/native/react-native.md
- controller/native/session-flow.md
- controller/presets.md
- controller/sessions.md
- controller/signer-management.md
- controller/starter-packs.md
- controller/toast-notifications.md
- controller/usernames.md
- services/vrng/how-it-works.md
- services/vrng/index.md

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

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:121 — page not found: ./configuration → /controller/configuration
  controller/examples/react.md:265 — page not found: ./headless-authentication → /controller/headless-authentication
  services/vrng/index.md:135 — TODO resolved: Controller sessions → /controller/sessions

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

vercel Bot commented Jun 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 Jun 1, 2026 1:29am

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