[prrao87]

Why

Rust readers could only follow one step of the getting started page, the CSR example, and even that tab used different data and printed a different answer from the Python tab. The CSR page explained what refresh() does to the CSR but not how to keep it current in practice. In the sidebar, the benchmarks sat near the bottom and the two API references were separate top-level entries.

What changed

• Getting started has Rust tabs throughout. Each Python snippet (the datasets, the graph config, the first query, parameters, the CSR, one-off queries) now has a Rust tab with the same data and query. The tabs are linked, so choosing Rust once switches the whole page. The CSR tab now uses the same in-memory graph as the Python tab, so both tabs print the same answer.
• The Rust code is compiled and run. As the docs guidelines require, it lives in a getting_started function of the embedded_query example, and the page pulls it in with --8<--. CI already runs that example. Each section ends with the table it prints.
• A new "How to keep the CSR fresh" section on the CSR page. It covers when to call refresh(), how to check the result with csr_stats(), and what forces a full rebuild instead of a delta (overwriting a relationship dataset, or removing the pinned version before refreshing). It has Python and Rust examples; the Rust tab reuses the example's existing refresh section.
• Sidebar order. Benchmarks now comes right after Getting started. The Python and Rust (docs.rs) API references are grouped under one "API reference" section.

There are no API or behaviour changes.

Validation

• cargo run -p lance-csr --example embedded_query: runs, and every new section prints what its output comment says.
• cargo fmt --all -- --check and cargo clippy -p lance-csr --example embedded_query -- -D warnings: clean.
• docs/check_snippets.py against a fresh make install of this branch: all blocks pass, and the new CSR snippet prints 5 1 delta as its comment says.
• uv run --project docs --locked zensical build --strict: no issues. uvx typos@1.26.0 .: clean.
• In a browser, against the built site: the sidebar order is right, the new CSR section renders, and selecting Rust on one getting started tab switches all six code tabs.
• No benchmarks: no engine code changed. CI is pending.

🤖 Generated with Claude Code

[cloudflare-workers-and-pages]

Deploying lance-csr with    Cloudflare Pages

Latest commit:	4291b2d
Status:	✅  Deploy successful!
Preview URL:	https://c174671f.lance-csr.pages.dev
Branch Preview URL:	https://docs-getting-started-rust-ta.lance-csr.pages.dev

View logs