Skip to content

Fix broken cross-site links: move files to match published URLs#1071

Merged
louis-pre merged 5 commits into
mainfrom
fix-broken-cross-site-links
Apr 21, 2026
Merged

Fix broken cross-site links: move files to match published URLs#1071
louis-pre merged 5 commits into
mainfrom
fix-broken-cross-site-links

Conversation

@louis-pre

Copy link
Copy Markdown
Member

Summary

Move files so their disk paths match the URLs that GitBook publishes. This fixes 405 of 475 broken cross-site links found by the link validator.

Changes

File moves

  • docs/guides/products/*docs/guides/capability-guides/* (21 files) — eliminates the products/ directory entirely
  • docs/guides/core-concepts/webhooks.mddocs/guides/developer-tools/webhooks.md

Link updates

  • Update 270 relative links in 119 files from products/ to capability-guides/
  • Update 44 relative links from core-concepts/webhooks to developer-tools/webhooks
  • Update SUMMARY.md paths

codegen/data/paths.yaml fixes

  • Fix lock description linking to thermostats instead of smart-locks
  • Remove .md extension from API URL

Remaining (70 broken links)

All from @seamapi/types OpenAPI descriptions — need to be fixed upstream:

  • Malformed paths (access-control-systems/ instead of acs/, doubled prefixes, double .md)
  • Wrong parent directories (device-and-system-integration-guides/ instead of device-guides/)
  • Nonexistent paths (core-concepts/access-codes, mobile/ios/quickstart)

🤖 Generated with Claude Code

@louis-pre louis-pre requested review from a team as code owners April 21, 2026 00:11
louis-pre and others added 3 commits April 20, 2026 17:16
- Fix lock description linking to thermostats instead of smart-locks
- Remove .md extension from API URL

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Move products/ files into capability-guides/ and webhooks from
core-concepts/ to developer-tools/ so file paths match the URLs
that GitBook publishes. Update all relative links and SUMMARY.md.

Eliminates the products/ directory entirely.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Fix escaped underscores in thermostat set_temperature_threshold URLs
- Fix mobile/ios/quickstart → developer-tools/mobile-sdks/ios-sdk

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@louis-pre louis-pre force-pushed the fix-broken-cross-site-links branch from b7ce3ec to b1cebae Compare April 21, 2026 00:17
seambot and others added 2 commits April 21, 2026 00:19
The \_  escaping is intentional GitBook markdown to prevent italic
rendering. The validator should handle this, not the content.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@louis-pre louis-pre merged commit 2fbec7f into main Apr 21, 2026
11 checks passed
@louis-pre louis-pre deleted the fix-broken-cross-site-links branch April 21, 2026 00:43
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