IA-v2: Sidebar reshuffle + scenarios/ rename + Concepts + Embed topics

[brianlagunas]

Summary

Bundles three related changes that together shift the Web SDK docs onto the new scenario-led IA:

1. Sidebar reshuffle to scenario-led IA

Restructures webSidebar around customer goals (per industry convention from Tableau, Power BI, Sisense, ThoughtSpot, QuickSight, Looker). Reveal's previous feature-bucket IA was the outlier.

New top-level groups: Get Started → Embedding → Common Patterns → Connect Data → Export and Share → Server Configuration → Reference → Releases. The "Customizing the Reveal View" group dissolves; "Visualizations" dissolves (members go to Reference). Existing pages slot into transitional positions awaiting per-page rewrite.

2. Folder rename: customizing/ → scenarios/

"Customizing" was too narrow once Common Patterns grew to cover non-customization scenarios. "scenarios" is generic and future-proof. EN + JA. Common Patterns promoted to top-level.

3. New foundational topics

• docs/web/concepts.md — mental model for client/server split, .rdash files, the four provider interfaces, and how a request flows through the SDK. Read once; the rest of the docs assume this vocabulary.
• docs/web/embedding/dashboard.md — canonical "embed a full dashboard" topic. Minimum code, variations, what's-next links into Common Patterns.
• docs/web/embedding/single-visualization.md — net-new content (was a documented gap). Covers Single Visualization Mode (locked) and Maximized Visualization (with navigation), plus dynamic switching.

Sidebar after this PR

Get Started
├── Overview
├── Concepts                    (NEW)
├── Installation (sub-cat)
├── Quickstart — Server (sub-cat)
└── Quickstart — Client (sub-cat)

Embedding
├── Embed a Dashboard           (NEW — canonical)
├── Embed a Single Visualization (NEW — canonical)
├── Loading                     (transitional)
├── Creating                    (transitional)
└── Saving                      (transitional)

Common Patterns                 (top-level, was sub-cat)
├── Read-only Embed
├── Editor on Load (Kiosk)
├── Custom Save Destination
├── Locked-down Export Menu
├── Filtering, Linking, Click Events,
    Theming, Localization       (transitional, awaiting scenario rewrite)

Connect Data
Export and Share
Server Configuration
Reference (incl. Editor Events, Custom Visualizations,
           Custom Menu Items, Customizing Map Tiles,
           Tooltips, Maximizing, Chart Types as feature topics)
Releases

Redirects added

• /web/editing-dashboards → /web/scenarios (target updated to follow rename)

Cross-links updated

• editor-events.md (EN + JA): link to customizing/index.md → scenarios/index.md

Known follow-ups (per the rewritten IA-v2 plan)

• Sub-PRs Setup AureDevOps build for release #4–7: Migrate Click Events, Filtering, Linking, Theming, Localization to proper Common Patterns scenarios; delete the transitional pages
• Sub-PR Final review of the guide (in staging) before going live #8: Extract IRVDashboardProvider from Loading/Saving into a dedicated Dashboard Provider topic under Connect Data
• Sub-PR Fix links to licenses in Third Party Software topic. #9: Custom Queries enrichment (USER PRIORITY)
• Sub-PRs Update Theme to use latest Reveal theme #10–12: Multi-Tenant, Row-Level Security, Custom Viz Library Solutions guides (USER PRIORITY)
• Sub-PR Added reveal template #13: Reference section finalization including Events Reference index
• Cleanup PR: drop transitional Loading/Creating entries once Embed a Dashboard absorbs their unique content; consider deleting maximizing-visualizations.md (its content is in Embed a Single Visualization)

Test plan

• npm run build passes for both en and ja locales
• Verified /web/customizing/view-only-embed/ still resolves (page accessible at new path)
• Verified /web/editing-dashboards/ redirects to /web/scenarios/
• Concepts page links validated: install pages, embedding pages, scenarios overview, datasources
• Reviewer to walk every entry in the new sidebar locally
• Reviewer to read Concepts page top-to-bottom and confirm the mental model is accurate
• Reviewer to flag any technical inaccuracies in Embed a Dashboard / Embed a Single Visualization (especially the singleVisualizationMode + maximizedVisualization interaction)

🤖 Generated with Claude Code