Skip to content

fix(docs): P0 quality fixes with regression tests - #651

Closed
diberry wants to merge 1 commit into
bradygaster:devfrom
diberry:squad/62-p0-docs-tdd
Closed

fix(docs): P0 quality fixes with regression tests#651
diberry wants to merge 1 commit into
bradygaster:devfrom
diberry:squad/62-p0-docs-tdd

Conversation

@diberry

@diberry diberry commented Mar 27, 2026

Copy link
Copy Markdown
Contributor

TDD approach: regression tests written first (red), then fixes applied (green).

P0 fixes from diberry#62 analysis:

  • 10 duplicate H2 headings removed across features + scenarios pages
  • Streams title mismatch fixed (SubSquads → Streams)
  • 6 orphan pages deleted (guide.md, sample-prompts.md, tips-and-tricks.md, tour-*.md)
  • Dangling link in gitlab-issues.md fixed
  • Internal link in personal-squad.md corrected

Regression tests added:

  • Duplicate H2 heading scanner (catches future copy-paste bugs)
  • Orphan page detector (with KNOWN_ORPHANS for intentional exclusions)
  • Nav/title mismatch checker (with KNOWN_MISMATCHES for stylistic choices)

All 3 new tests pass. 25 total tests (22 existing + 3 new).

@bradygaster — docs quality fixes from IA analysis. TDD-verified with regression guards.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

…atch + regression tests

- Remove duplicate H2 headings in team-setup, routing, parallel-execution, directives
- Fix Streams title mismatch (SubSquads → Streams)
- Delete 6 orphan pages not in navigation (guide.md, sample-prompts.md, tips-and-tricks.md, tour-*.md)
- Fix internal link in personal-squad.md
- Add 3 regression tests: duplicate H2 detection, orphan page detection, nav/title mismatch detection

Closes #62 (partial — P0 items)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@diberry

diberry commented Mar 28, 2026

Copy link
Copy Markdown
Contributor Author

Closing -- will re-open via fork-first pipeline when fully polished.

@diberry diberry closed this Mar 28, 2026
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.

2 participants