docs: use-case IA overhaul — stablecoins, DeFi, stocks, payments, and ledgers - #1772
Open
youssefea wants to merge 7 commits into
Open
docs: use-case IA overhaul — stablecoins, DeFi, stocks, payments, and ledgers#1772youssefea wants to merge 7 commits into
youssefea wants to merge 7 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
|
- Update subtitle to "The blockchain for global finance." - Remove the Explore section; add a Solutions card per use case (stablecoins, lending, tokenized stocks, payments, private txns) - Rename "Facilitate Payments" -> "Accept Payments" (landing, nav group, and page title) - Resources: drop Retroactive Funding and Join the Base Ecosystem, add Base dashboard link - Set card titles to 1.25rem Co-Authored-By: Claude <noreply@anthropic.com>
Co-authored-by: Codex <codex-noreply@coinbase.com>
youssefea
changed the title
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 and why
Restructures Base documentation from product-based navigation to a use-case-based IA for fintechs, brokerages, PSPs, and technical decision-makers. The Get Started tab explains each financial outcome; Build on Base contains short, single-action implementation guides.
This PR supersedes #1770, which was auto-closed when the branch was renamed to
docs/use-case-ia-overhaul.Use-case IA
Build on Base
StablecoinDemoDeFiDemoAssetDemoPaymentsDemonow includes the B20 flowLedgersDemoChain and SDK/API reference
Compatibility and redirects
/apps/guides/accept-b20-paymentsto a semantically correct B20 payment destinationAGENTS.md,llms.txt, andllms-full.txtValidation
base-std; calldata signatures were validatedThe full-repository linter still reports unrelated pre-existing issues in legacy specifications, legal pages, and snippet partials; no changed page contributes to that baseline.