Problem
Over 120 files in embedded-wallets/ have description frontmatter that doesn't meet editorial
standards (see .cursor/rules/markdown-formatting.mdc):
-
Uses "Web3Auth" instead of "Embedded Wallets" in the description field. Per
product-embedded-wallets.mdc, the product name in prose and metadata should be
"Embedded Wallets" (not "Web3Auth").
-
Pipe-delimited keyword strings instead of SEO sentences. Most descriptions follow the
pattern 'Web3Auth <Platform> SDK - <Feature> | Embedded Wallets'. The style guide requires
a single descriptive sentence for SEO and previews.
-
Redundant sidebar_label on some pages where the value duplicates what the title already
provides.
Example (current)
description: 'Web3Auth iOS SDK - Using Custom Authentication | Embedded Wallets'
Example (expected)
description: Authenticate users with your own identity provider using the Embedded Wallets iOS SDK.
Scope
All .mdx files under embedded-wallets/ with a description field referencing "Web3Auth."
This includes:
sdk/ (iOS, Android, React, React Native, Vue, JS, Flutter, Unity, Unreal, Node) — ~100 files
dashboard/ — ~8 files
infrastructure/ — 3 files
connect-blockchain/ — 1 file
Suggested approach
- Rewrite each
description as a single sentence that uses "Embedded Wallets" as the product
name, describes what the page covers, and works as an SEO snippet.
- Remove
sidebar_label where it duplicates the title.
- Validate that no page has both a
title frontmatter field and a duplicate # Heading.
Problem
Over 120 files in
embedded-wallets/havedescriptionfrontmatter that doesn't meet editorialstandards (see
.cursor/rules/markdown-formatting.mdc):Uses "Web3Auth" instead of "Embedded Wallets" in the description field. Per
product-embedded-wallets.mdc, the product name in prose and metadata should be"Embedded Wallets" (not "Web3Auth").
Pipe-delimited keyword strings instead of SEO sentences. Most descriptions follow the
pattern
'Web3Auth <Platform> SDK - <Feature> | Embedded Wallets'. The style guide requiresa single descriptive sentence for SEO and previews.
Redundant
sidebar_labelon some pages where the value duplicates what the title alreadyprovides.
Example (current)
Example (expected)
Scope
All
.mdxfiles underembedded-wallets/with adescriptionfield referencing "Web3Auth."This includes:
sdk/(iOS, Android, React, React Native, Vue, JS, Flutter, Unity, Unreal, Node) — ~100 filesdashboard/— ~8 filesinfrastructure/— 3 filesconnect-blockchain/— 1 fileSuggested approach
descriptionas a single sentence that uses "Embedded Wallets" as the productname, describes what the page covers, and works as an SEO snippet.
sidebar_labelwhere it duplicates thetitle.titlefrontmatter field and a duplicate# Heading.