docs: use-case IA overhaul — Payments, SDKs & APIs, Ledgers; cut off-strategy sections - #1772
Open
youssefea wants to merge 5 commits into
Open
docs: use-case IA overhaul — Payments, SDKs & APIs, Ledgers; cut off-strategy sections#1772youssefea wants to merge 5 commits into
youssefea wants to merge 5 commits into
Conversation
Turn the Issue Stablecoins stub into a Stripe-style, demo-driven section built around the B20 stablecoin variant. - Get Started landing (get-started/issue-stablecoins) with an interactive demo above a CardGroup of the issuer jobs - Eight short, single-purpose Build on Base pages: issue, mint, burn, restrict, block, recover, pause, reconcile - New self-contained StablecoinDemo.jsx snippet (flow selector, timeline, progress bar, animated log, balances) replacing the Visibility-wrapped reuse that failed to render - Nav: Issue Stablecoins ordered above Integrate DeFi in both tabs; redirect for the removed stub; page title capitalized Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
…tegy sections
Execute the use-case IA overhaul (Phases 1–4) on top of the skeleton.
Facilitate Payments (Phase 1)
- New Solutions landing get-started/agentic-payments + 5 byte guides under
build-on-base/agentic-payments (accept, verify, payer info, subscriptions, x402)
- New scripted snippets/PaymentsDemo.jsx (5 flows), modeled on StablecoinDemo
- Rewrite get-started/base (use-case-first) and ecosystem-bridges (route chooser)
SDKs & APIs (Phase 2)
- Relocate base-account -> sdks/base-account (whole tree; preserves link equity)
- Curated tab: Overview / Base Account SDK / Base Chain API
- New sdks/overview (hub) + sdks/base-account/overview (SDK landing)
The cut (Phase 3)
- Delete /agents (Base MCP), /apps (MiniKit), /onchainkit
- 301-redirect every removed/moved URL (615 -> 791); repoint 362 destinations
out of cut trees; fix 133 pre-existing danglers; repoint surviving cross-links
- Delete stale per-section llms shards; regenerate AGENTS.md + llms.txt/llms-full.txt
Scaffolding (Phase 4)
- Fill Start Here trio, use-base-with-ai (x402), build-on-base/overview,
get-started/{base-chain,sdks-and-apis} landings
Tooling: fix two real lint-mdx.js bugs (closing fences and HTML comments inside
fenced code blocks were false-flagged). No lint errors in new/migrated content.
Co-Authored-By: Claude <noreply@anthropic.com>
…t DeFi/Perps
Nav & IA refinements on top of the use-case overhaul:
- Get Started "Agents" group renamed to "Coding agents" = resources-for-ai-agents,
docs-mcp, docs-llms. Removed "Build on Base with AI" (use-base-with-ai); repointed
its 69 inbound redirects to resources-for-ai-agents.
- Reshaped Ledgers to the byte-guide pattern: removed ledgers-overview and folded its
value-prop into the get-started/private-transactions landing; added small single-intent
guides build-on-base/ledgers/{deposit,transfer,withdraw} with scoped demos; new
snippets/LedgersDemo.jsx (deposit/transact/withdraw flows with a privacy readout).
- Removed the Perps section and the Integrate DeFi section (Get Started + Build on Base).
Perps redirects to overview; DeFi removed without redirects (empty stubs).
- Title Case across all sidebar page titles and group names, preserving code identifiers
(method names) and acronyms/brands.
- Added a site-wide draft banner and marked the "SDKs & APIs [WIP]" tab.
- Regenerated AGENTS.md, llms.txt, llms-full.txt.
Co-Authored-By: Claude <noreply@anthropic.com>
Remove the orange `type`/`color` override; keep the default banner style. Co-Authored-By: Claude <noreply@anthropic.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Collaborator
🟡 Heimdall Review Status
|
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
3 participants
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.
What changed? Why?
Restructures the docs from product-based to use-case-based navigation for technical decision-makers, and executes the sections on top of it. (Supersedes #1770, which was auto-closed when its poorly-named branch
mux/docs-claude-2was renamed todocs/use-case-ia-overhaul— same work, correctly named branch.)IA & Get Started
get-started/baseandecosystem-bridgesresources-for-ai-agents,docs-mcp,docs-llmsBuild on Base (use-case sections)
PaymentsDemoLedgersDemowith a privacy readout; overview folded into the landingSDKs & APIs
base-account→sdks/base-account(preserves link equity); curated into Base Account SDK + Base Chain API; new hub + SDK landingThe cut
/agents(Base MCP),/apps(MiniKit),/onchainkit, plus the empty Perps and Integrate DeFi stubsAGENTS.md/llms.txt/llms-full.txtPolish
Notes to reviewers
scripts/lint-mdx.js(closing fences + HTML comments inside code fences were false-flagged). Remaining lint errors are all pre-existing (snippet component false-positives, spec/legal multiple-H1).How has it been tested?
mintlify devrenders new/changed pages; all demos load andflowscoping worksnode scripts/lint-mdx.js all: 0 errors in new/migrated content