Navigation: Relocate reference links in learning path sections

[amotl]

About

In pure "learning path" sections, relocate reference links to bottom of page.

Preview

• https://cratedb-guide--379.org.readthedocs.build/start/query/aggregations.html
• https://cratedb-guide--379.org.readthedocs.build/start/query/ad-hoc.html
• https://cratedb-guide--379.org.readthedocs.build/start/query/ai-integration.html

References

• Documentation UX: Reconsider placement and handling of reference links #372

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

Adds new external link anchors to the shared links include and restructures multiple documentation pages. The connect index is reorganized with updated rubrics and references. Three “start/query” pages replace prior grid/rubric layouts with a unified “Further reading” card-based section. No public APIs changed.

Changes

Cohort / File(s)	Summary
Links include updates docs/_include/links.md	Adds new external link definitions (e.g., ADBC, JDBC/ODBC, protocols, SQL, examples) without modifying existing anchors.
Connect index restructuring docs/connect/index.md	Renames “Reference Manual” to “Reference”; removes “Protocols and API Standards” rubric; re-groups links under “Reference” and new “Related” section; adjusts/removes several external references.
Start/query pages: layout overhaul docs/start/query/ad-hoc.md, docs/start/query/aggregations.md, docs/start/query/ai-integration.md	Replaces prior grid/rubric sections with a “Further reading” area using grid-item-card groups; updates and relocates associated references; core narrative content retained.

Sequence Diagram(s)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related issues

• Documentation UX: Reconsider placement and handling of reference links #372 — Implements the proposed regrouping of links into “Further reading” and related structural/navigation changes across affected docs.

Possibly related PRs

• Connect: Reorganize and clean up section #361 — Also reorganizes docs/connect/index.md link structure and sections.
• Refine "home" and "connect" entry point pages #237 — Prior reshaping of connection cards and references in docs/connect/index.md.
• ETL/CDC: Guidance, Layout / Dissolve walls of links #239 — Similar replacement of dense link lists with card-based “Further reading” and additions in docs/_include/links.md.

Suggested reviewers

• bmunkholm
• kneth

Poem

A hop, a skip, I tidy the trails,
Cards now guide where the old list fails.
Links sprout fresh like clover in spring,
“Further reading” is the tune I sing.
With whiskers twitching, docs align—
Thump of approval: everything’s fine. 🐇✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The title succinctly and accurately summarizes the primary change—relocating reference links in learning path sections—without extraneous details or ambiguity, making it clear to reviewers and maintainers what the pull request accomplishes.
Description Check	✅ Passed	The pull request description directly relates to the changeset by explaining that reference links in learning path sections are being relocated to the bottom of the page and provides preview links and issue references, demonstrating relevance and context.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 660d81c and ed44445.

📒 Files selected for processing (5)

• docs/_include/links.md (5 hunks)
• docs/connect/index.md (1 hunks)
• docs/start/query/ad-hoc.md (1 hunks)
• docs/start/query/aggregations.md (1 hunks)
• docs/start/query/ai-integration.md (1 hunks)

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[bmunkholm]

Shouldn't this be removed as we are not using it anywhere (and I also don't think we should).

[bmunkholm]

Same - remove?