Skip to content

Add HTML link checking, move files to match SUMMARY nesting, fix all broken links#1091

Merged
louis-pre merged 4 commits into
mainfrom
fix-ecobee-landing-page
Apr 22, 2026
Merged

Add HTML link checking, move files to match SUMMARY nesting, fix all broken links#1091
louis-pre merged 4 commits into
mainfrom
fix-ecobee-landing-page

Conversation

@louis-pre

@louis-pre louis-pre commented Apr 22, 2026

Copy link
Copy Markdown
Member

Summary

1. Extend validators (bb9dc91a)

  • validate-links: Check <a href> tags (relative + absolute docs.seam.co URLs)
  • validate-paths: Check that nested SUMMARY.md entries have file paths under their parent's directory, matching how GitBook builds published URLs

2. Move files to match SUMMARY.md nesting (10b51ccf)

  • Moved 10 brand-guide get-started pages into their parent directories (e.g., get-started-with-ecobee-thermostats.mdecobee-thermostats/)
  • Moved 2 guides files to match their SUMMARY.md parent paths

3. Fix all broken HTML links (789e9277)

  • Fix asset paths in brand-guides (wrong ../ depth after section move)
  • Fix cross-section asset refs to guides/.gitbook/assets/
  • Fix brand-guides and guides landing page card links
  • Fix cross-section API, capability guide, and device guide links
  • Fix internal links broken by the file moves

Test plan

  • npm run validate-links passes
  • npm run validate-paths passes
  • npx tsc --noEmit passes
  • Verify card links on guides landing page
  • Verify card links on brand-guides landing page
  • Verify ecobee card links to the correct page

🤖 Generated with Claude Code

@louis-pre louis-pre requested review from a team as code owners April 22, 2026 05:59
@louis-pre louis-pre changed the title Fix ecobee card on guides landing page Add HTML link checking and fix all broken HTML links Apr 22, 2026
@louis-pre louis-pre changed the title Add HTML link checking and fix all broken HTML links fix: Add HTML link checking and fix all broken HTML links Apr 22, 2026
louis-pre and others added 2 commits April 21, 2026 23:44
- Add HTML <a href> link checking to validate-links (both relative and
  absolute docs.seam.co URLs)
- Stop absolute URL pattern at quote characters for HTML compatibility
- Extend validate-paths to check that nested SUMMARY.md entries have
  file paths under their parent's directory, matching how GitBook builds
  published URLs from the tree structure

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
GitBook derives published URLs from SUMMARY.md tree nesting. Files
nested under a parent must live in the parent's directory. Moved 10
brand-guide get-started pages into their parent directories and 2
guides files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@louis-pre louis-pre force-pushed the fix-ecobee-landing-page branch from f710a0c to 789e927 Compare April 22, 2026 06:46
@louis-pre louis-pre changed the title fix: Add HTML link checking and fix all broken HTML links Add HTML link checking, move files to match SUMMARY nesting, fix all broken links Apr 22, 2026
Fix broken links found by the new HTML link checker:
- Fix asset paths in brand-guides (wrong ../ depth after section move)
- Fix cross-section asset refs pointing to guides/.gitbook/assets/
- Fix brand-guides/README.md card links to use correct local paths
- Fix guides/README.md card links with correct absolute URLs
- Fix cross-section API and capability guide links
- Fix internal links broken by file moves

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@louis-pre louis-pre force-pushed the fix-ecobee-landing-page branch from da91316 to fd012bb Compare April 22, 2026 06:49
@louis-pre louis-pre merged commit 74bd840 into main Apr 22, 2026
12 checks passed
@louis-pre louis-pre deleted the fix-ecobee-landing-page branch April 22, 2026 06:53
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