Skip to content

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

Closed
diberry wants to merge 1 commit intodevfrom
squad/62-p0-docs-tdd
Closed

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

Conversation

@diberry
Copy link
Copy Markdown
Owner

@diberry diberry commented Mar 27, 2026

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

P0 fixes from #62 analysis:

  • Duplicate H2 headings removed from 4 feature pages (team-setup, routing, parallel-execution, directives)
  • Streams title mismatch fixed (SubSquads → Streams)
  • 6 orphan pages deleted (guide.md, sample-prompts.md, tips-and-tricks.md, tour-*.md)
  • Internal link fixed in personal-squad.md

Regression tests added:

  • Duplicate H2 heading scanner (catches future copy-paste bugs)
  • Orphan page detector (catches pages missing from navigation.ts)
  • Nav/title mismatch checker (catches frontmatter vs nav title drift)

Closes #62 (P0 items)

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 force-pushed the squad/62-p0-docs-tdd branch from 50ae91d to 2f5a6f1 Compare March 27, 2026 12:24
@diberry
Copy link
Copy Markdown
Owner Author

diberry commented Mar 27, 2026

✅ Team Approved

TDD verified: 3 P0 regression tests pass (duplicate H2, orphan pages, nav/title mismatch). 1 commit, 19 files.

Fixes applied:

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

Regression guards:

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

Ready to retarget upstream.

@diberry
Copy link
Copy Markdown
Owner Author

diberry commented Mar 27, 2026

Retargeted to bradygaster#651

@diberry diberry closed this Mar 27, 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