Docs v3: Rewrite start-free-with-cloud as overview + router page

[doriwilson]

Summary

This PR rewrites start-free-with-cloud.md from a ~350-line mega-page into a ~160-line overview + router page. The previous version duplicated YAML code blocks and configuration instructions already covered by dedicated setup pages. The rewrite removes all duplication and routes users to spoke pages instead.

• 351 → 160 lines (54% reduction)
• All YAML code blocks removed (profiles.yml, base-workflow.yml, pr-workflow.yml)
• Hub-and-spoke navigation with breadcrumb admonitions on spoke pages
• Fixed env var inconsistency (CI_SCHEMA → SNOWFLAKE_SCHEMA)
• Fixed workflow name mismatch in verification step

What changed vs earlier docs-v3

start-free-with-cloud.md (primary rewrite)

Removed:

• profiles.yml YAML block + explanation (~40 lines) — already in environment-setup.md
• base-workflow.yml YAML block + explanation (~55 lines) — already in setup-cd.md
• pr-workflow.yml YAML block + explanation (~55 lines) — already in setup-ci.md
• "About Secrets" standalone section — retained as one inline sentence
• "Set Up Profile.yml" section header and walkthrough
• "Set Up Base Metadata Updates" section header and walkthrough
• "Set Up Current Metadata Updates" section header and walkthrough
• recce vs recce-cloud verbose admonition — condensed to one sentence
• "This guide covers" bullets and verbose goal preamble
• "[Experimental]" label on Web Agent section
• "Coming soon" note about agent expansion

Replaced with:

• Step 3a/b/c: 1-2 sentence descriptions + bold links to environment-setup.md, setup-cd.md, setup-ci.md
• Steps 1-2: 1 sentence each + links to connect-to-warehouse.md, connect-git.md
• Router table: updated "Continue with this guide" self-referencing links → plain text "Continue reading below"
• Next Steps: added descriptions to each link

Kept unchanged:

• Frontmatter, H1, Get Started button, Loom video embed
• Prerequisites (4 checkboxes)
• Onboarding Process Overview (4 steps)
• Recce Web Agent Setup (3 bullets)
• "Choose your setup" router table (structure preserved, links updated)
• Step 4: Merge the CI/CD change + screenshot
• Step 5: Final Steps
• Verification Checklist (3 items)
• Troubleshooting table (6 rows)

environment-setup.md

• Fix: CI_SCHEMA → SNOWFLAKE_SCHEMA in profiles.yml example (line 66), env var snippets (lines 96, 103), and prose (lines 84, 109)
• Fix: pr_123 → PR_123 in prose to match actual YAML output casing
• Added: Breadcrumb admonition at top: "Following the onboarding guide? Return to Get Started with Recce Cloud"
• Added: Note that other warehouses use their own variable name

setup-cd.md

• Fix: Verification step said "Update Base Recce Session" but workflow YAML defines name: Update Base Metadata — updated to match
• Added: Breadcrumb admonition at top

setup-ci.md

• Added: Breadcrumb admonition at top

gitlab-pat-guide.md

• No changes — existing anchor #2-connect-git-provider still resolves correctly

Review notes

• Editor review flagged two critical issues (both fixed): self-referencing table links and workflow name mismatch
• Non-blocking recommendations for follow-up: consistent Base/Current capitalization, rename "Step 5: Final Steps", clarify non-Snowflake variable names

Test plan

• mkdocs serve renders all 4 changed pages without warnings
• No YAML code blocks on start-free-with-cloud.md
• Router table renders correctly
• Video embed works
• All internal links clickable (especially #3-add-recce-to-cicd and #2-connect-git-provider anchors)
• Breadcrumb admonitions on spoke pages link back correctly
• Prerequisites and verification checklist unchanged

🤖 Generated with Claude Code