Adopt structured status tags and [!BETA]/[!DEPRECATED] callouts#3387
Draft
manovotny wants to merge 19 commits into
Draft
Adopt structured status tags and [!BETA]/[!DEPRECATED] callouts#3387manovotny wants to merge 19 commits into
manovotny wants to merge 19 commits into
Conversation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…th inline callouts
…ETA] Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…!DEPRECATED] Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…!DEPRECATED]/[!BETA] Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…egacy hooks Adds `legacy` to the tag enum (used for both frontmatter and manifest validation). Retags the SignIn/SignUp object pages and the legacy useSignIn/useSignUp hooks from `deprecated` to `legacy`, strips the redundant "(Legacy)" suffix from the object titles and their manifest nav entries, and softens their body callouts from [!DEPRECATED] to [!WARNING]. The invalid-tag error message now derives from the enum so it can't drift. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
The beta status is now conveyed by the title/sidenav pill, so the tag no longer needs to be baked into the hero artwork. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Brings content that landed on main since this branch diverged in line with the new status system: - Agent Tasks (beta): flip the shared callout partial from [!WARNING] to [!BETA]; add tag: beta to the 4 agent-tasks pages (frontmatter) and the standalone guide/type manifest entries; the backend create/revoke inherit beta from their Agent Tasks manifest group. Converts the manifest's legacy '(Beta)' strings to the lowercase enum. - Legacy custom-flow guides: add tag: legacy and strip the redundant '(Legacy)' suffix from the 13 custom-flows/authentication/legacy/*.mdx titles (status now conveyed by the pill + Legacy nav group). - directory-sync: convert the two inline [!NOTE] 'is in public beta' notices to [!BETA] (page stays untagged; only those sub-features are beta). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🔎 Previews:
/docs/reference/objects/sign-in&/sign-up(Legacy pill),/docs/reference/hooks/legacy/use-sign-in&/use-sign-up, plus the Clerk Elements and Expo native-components pages (deprecated/beta callouts).What does this solve? What changed?
Status (beta, community, deprecated, legacy) was conveyed inconsistently — baked into titles (
(beta),(Legacy)) and scattered across per-feature callout partials. This migrates the content to a structuredtagfrontmatter field plus standardized[!BETA]/[!DEPRECATED]callouts, which the renderer turns into status pills.beta | community | deprecated | legacy; parsed and validated in page frontmatter and the manifest; carried through generated SDK redirect pages.[!BETA]/[!DEPRECATED]; deleted obsolete beta partials and updated their callers.SignIn/SignUpobjects and the legacyuseSignIn/useSignUphooks move fromdeprecatedtolegacy; their redundant "(Legacy)" title/manifest suffixes are dropped and their body callouts softened to[!WARNING].tagfield,[!BETA]/[!DEPRECATED], and inline status components in CONTRIBUTING/STYLEGUIDE.Renderer companion PR: clerk/clerk#2621 — it teaches the docs app these tags and must merge first. It's backward-compatible; this content PR is not safe to ship ahead of it (the deployed renderer would reject
tag: legacy).Deadline
Other resources