Skip to content

[docs] docs: unbloat troubleshooting/common-issues.md (~25% reduction)#20280

Closed
github-actions[bot] wants to merge 1 commit intomainfrom
docs/unbloat-common-issues-749b65a37568a098
Closed

[docs] docs: unbloat troubleshooting/common-issues.md (~25% reduction)#20280
github-actions[bot] wants to merge 1 commit intomainfrom
docs/unbloat-common-issues-749b65a37568a098

Conversation

@github-actions
Copy link
Contributor

@github-actions github-actions bot commented Mar 10, 2026

Reduces docs/src/content/docs/troubleshooting/common-issues.md from 455 → 342 lines (113 lines removed, 24.8% reduction) by removing structural bloat while preserving all essential information.

What was improved

Section Before After Change
Copilot License Issues Multi-step numbered diagnostic with 3 code blocks Single concise paragraph −18 lines
Custom Actions Not Allowed 4-step numbered list + Option 1/2/Verification subsections Two bullet points −17 lines
GitHub Lockdown Mode Symptoms / Cause / Solution sub-headers Single prose block −15 lines
Cannot Find Module 'playwright' Error block + cause/solution + 20-line code example One-liner with link −25 lines
Playwright EOF Error Error block + cause + code block Inline description −8 lines
Debugging sections Two redundant entries: "How Do I Debug" + "Debugging Strategies" Single merged "Debugging a Failing Workflow" −6 lines
Workflow Job Timed Out Redundant intro + duplicate code example Minimal with single code block −12 lines

Types of bloat removed

  • Cause/Solution/Symptoms sub-headers flattened into prose
  • Redundant numbered steps compressed into bullet points or prose
  • Duplicate debugging entries merged
  • Verbose code examples that showed the same concept twice (incorrect vs. correct Playwright usage) replaced with a link to docs
  • Repetitive introductory sentences that simply restated the section heading

Verification

  • npm run build passes with all internal links valid ✅
  • No essential technical content removed ✅

Issues

Screenshots: Could not be captured. The sandbox network firewall blocks the Playwright browser from connecting to the local preview server (net::ERR_CONNECTION_REFUSED for both localhost:4321 and 172.30.0.20:4322).

References:

🗜️ Compressed by Documentation Unbloat ·

  • expires on Mar 12, 2026, 12:08 AM UTC


✨ PR Review Safe Output Test - Run 22881817319

💥 [THE END] — Illustrated by Smoke Claude ·

Reduce documentation bloat by ~25% (455 → 342 lines, 113 lines removed):

- Condense "Copilot License Issues" from multi-step diagnostic flow to a concise paragraph
- Collapse "Custom Actions Not Allowed" from numbered steps + sections into two bullet points
- Flatten "Lockdown Mode" Symptoms/Cause/Solution pattern into prose
- Replace "Cannot Find Module playwright" code block with a one-liner reference
- Convert "Playwright EOF Error" to inline description, removing standalone code block
- Merge "How Do I Debug" and "Debugging Strategies" into a single "Debugging a Failing Workflow" section
- Simplify "Workflow Job Timed Out" by removing redundant intro and inline code example

All essential information preserved; only wording and structure trimmed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions github-actions bot added automation documentation Improvements or additions to documentation labels Mar 10, 2026
@pelikhan pelikhan closed this Mar 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant