[cboettig]

Follow-up to #424, addressing the navigation. Docs-only, single file.

The page was organised language-first — R local, R server, Python local, Python server, then two more sections that didn't obviously belong to either — which buried the choice a reader is actually making.

Now it's venue-first, three numbered sections, each with the R version and then the Python version:

1. Local compute — a DuckDB on your own machine, no server involved
   • R — dplyr and duckdbfs
   • Python — ibis
2. The MCP server — the same pipeline, executed next to the data
   • R — dplyr, executed on the server
   • Python — ibis, executed on the server
   • Without dplyr or ibis (the raw-SQL examples, R then Python)
   • Local or server?
3. MCP and a chat model
   • R — ellmer + mcptools
   • Python — LangChain + LangGraph

Other changes:

• The intro now links to the three sections, so the shape of the page is visible before you scroll.
• The figure and its interpretation move up into the shared preamble. Previously they sat inside the R local subsection purely because R came first, which made the payoff of the example hard to find and implied it was an R-specific result.
• "Calling the MCP tools directly" becomes a subsection of the MCP server rather than a peer heading — it's the same server, just without dplyr or ibis in front of it.
• Dropped the per-subsection framing that the new section intros now carry, so the local-vs-server trade is explained once instead of three times.

No code or prose content changed — only ordering, headings and section intros. Site builds clean with no dead links (the numbered anchors are #_1-local-compute etc., which is how VitePress slugs headings that start with a digit).