Skip to content

feat: relocate Smart Locks and ACS to Low-Level APIs (Mintlify)#1121

Merged
sybohy merged 1 commit into
mainfrom
feat/mintlify-low-level-apis
Jun 9, 2026
Merged

feat: relocate Smart Locks and ACS to Low-Level APIs (Mintlify)#1121
sybohy merged 1 commit into
mainfrom
feat/mintlify-low-level-apis

Conversation

@sybohy

@sybohy sybohy commented Jun 9, 2026

Copy link
Copy Markdown
Member

Why

Ports the #1115 structural change (Smart Locks + ACS → a bottom-of-nav "Low-Level APIs" group) into the Mintlify docs, now that Mintlify is the source of truth and Dawn's polish (#1119) has landed.

Done by hand on top of #1119, not by re-running migrate-to-mintlify.mjs — a regen would have overwritten her hand edits (the whole reason we closed #1120).

What

  • Moved the smart-locks/ and access-systems/ MDX trees from capability-guides/low-level-apis/ (38 files).
  • docs.json (Guides tab): new Low-Level APIs group at the bottom, with nested Smart Locks / Access Control Systems sub-groups. (Mirrors the "Low-Level APIs" group Dawn already added to the API Reference tab in fix: Mintlify docs polish — links, redirects, and page rewrites #1119.)
  • Banners (<Warning>, matching the repo's component convention) on both section indexes: low-level API → use Access Grants for granting; talk to the Seam team before building on these. No deprecation language.
  • Pointer hints (<Info>) on the granting sub-pages: access codes, managing credentials, ACS quick starts, ACS user management.
  • Removed the stale "Access Grants and access methods APIs are currently in Alpha" notice from the card-encoding guide (the fix: remove outdated Access Grants Alpha notice from encoder guide #1117 fix, which the Mintlify tree hadn't picked up).
  • Rewrote ~166 internal links to the new paths, and added docs.json redirects for the two moved subtrees (wildcard + base).

Validation

  • docs.json is valid JSON; all 38 nav pages resolve to files; no stale capability-guides/{smart-locks,access-systems} refs remain in nav.
  • 0 dangling low-level-apis/ links across the whole MDX tree (verified with a resolver script).
  • The Mintlify Deployment check on this PR will build-validate.

Notes

  • mintlify broken-links can't run clean locally yet — it bails on a pre-existing MDX parse error in capability-guides/mobile-access/mobile-device-sdks/handling-system-permissions.mdx (a </Tab> nesting issue from fix: Mintlify docs polish — links, redirects, and page rewrites #1119, unchanged by this PR). Flagging for a separate fix; not in scope here.
  • I left the GitBook docs/ tree untouched, per "Mintlify is the source of truth going forward."
  • Redirects: added the obvious capability-guides → low-level-apis mappings. The broader old-URL/traffic audit you mentioned will be the backstop.

🤖 Generated with Claude Code

Ports the #1115 structural change into the Mintlify docs (now the
source of truth), on top of Dawn's #1119 polish — done by hand rather
than re-running the migration script so her edits are preserved.

- Move smart-locks and access-systems MDX trees under low-level-apis/
- docs.json Guides tab: new bottom "Low-Level APIs" group with nested
  Smart Locks / Access Control Systems sub-groups (matches the
  Low-Level APIs group Dawn already added to the API Reference tab)
- Warning banners on both section indexes: low-level API, use Access
  Grants for granting, talk to the Seam team before building on them
- Pointer hints on the granting sub-pages (access codes, managing
  credentials, ACS quick starts, ACS user management)
- Remove the stale 'Access Grants in Alpha' notice from the
  card-encoding guide (#1117)
- Rewrite ~166 internal links to the new paths; add docs.json redirects
  for the two moved subtrees

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sybohy sybohy requested a review from a team as a code owner June 9, 2026 01:32
@mintlify

mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
seam 🟢 Ready View Preview Jun 9, 2026, 1:39 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@sybohy sybohy merged commit 8e66e21 into main Jun 9, 2026
9 checks passed
@sybohy sybohy deleted the feat/mintlify-low-level-apis branch June 9, 2026 05:31
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.

1 participant