feat: relegate legacy granting guides to a Low-Level APIs section#1115
feat: relegate legacy granting guides to a Low-Level APIs section#1115sybohy wants to merge 2 commits into
Conversation
5006075 to
23b9aa2
Compare
23b9aa2 to
9a78cfb
Compare
|
Updated per Sy's review: removed the "expect to deprecate in the medium term" wording (no product sign-off, and it contradicted the GA changelog's "fully supported"). The banners now position these as low-level APIs — use Access Grants for granting access, and discuss your use case with the Seam team (support@seam.co) before building on them. No deprecation commitment anywhere in this PR now. |
Per review, relocate the entire Smart Locks and Access Control Systems capability sections to a new "Low-Level APIs" group at the bottom of the nav. Both trees keep their original internal structure (access codes under Smart Locks, credential management under ACS) — no extra nesting level. - Warning banners on both section overviews: low-level APIs; use Access Grants for granting; discuss other use cases with the Seam team (no deprecation commitment) - Pointer hints on the granting-relevant sub-pages (access codes, managing credentials, ACS quick starts, ACS user management) - .gitbook.yaml redirects for all 38 moved pages, plus retargeted pre-existing redirects that pointed into the moved trees - Repo-wide link updates; cross-section relative links fixed by depth Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
133caf0 to
9aa6fc6
Compare
|
Rebuilt per Sy's review: the whole Smart Locks and ACS sections now move under Low-Level APIs (not just the granting sub-trees), with their original internal structure intact and no extra nesting level — top-level entries are Smart Locks and Access Control Systems. 38 redirects in place; all validators green. Banner wording remains the soft "discuss with the Seam team" version. |
The home page should lead with the recommended granting path, not the low-level smart locks walkthrough. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Why
Part 2 of the Access Grants front-door refactor (#1114, merged). Access Grants are GA and recommended; the device-level Smart Locks and ACS APIs are the low-level surfaces and should no longer dominate the main nav.
What
The entire Smart Locks and Access Control Systems capability sections move to a new "Low-Level APIs" group at the very bottom of the left nav. Both trees keep their exact internal structure from before (access codes under Smart Locks, credential management under ACS) — the group's top-level entries are simply Smart Locks and Access Control Systems, no extra nesting.
.gitbook.yamlredirects for all 38 moved pages + retargeted pre-existing redirects that pointed into the moved treesValidation
validate-paths/validate-links/validate-orphan-pages/validate-redirects— all ✅docs.seam.coURLs in the auto-generated api-reference resolve via the new redirects (validator is redirect-aware)🤖 Generated with Claude Code