TOC: Primary navigation improvements 202602a

[amotl]

About

A few inches towards a recent proposal by @bmunkholm and @kneth to improve the primary navigation.

Details

• Effectively dissolve the "topics" section.
  • Relocate concerns about "software testing" into the "connect" section.
  • What's left after removing the link to the "machine learning" section are just category index pages referencing items within the "integrate" section, so just relocate them inside.
• Shuffle a few items within the primary navigation as suggested.

Preview

-- https://cratedb-guide--543.org.readthedocs.build/
-- https://cratedb-guide--543.org.readthedocs.build/connect/testing/

References

• https://github.com/crate/tech-content/issues/169#issuecomment-3859654348

/cc @surister, @matriv, @seut

[coderabbitai]

Walkthrough

This pull request restructures the documentation navigation and expands language driver coverage across three key sections: adding 20+ language-specific driver cards and Software Testing to the connect guide, reorganizing handbook navigation entries, and simplifying the integrate category overview while removing redundant Software Testing content.

Changes

Cohort / File(s)	Summary
Connect Guide Expansion docs/connect/index.md	Added Software Testing integration instruction card and expanded drivers/apps grid with 20+ new language-specific driver cards (ODBC, C#, Elixir, Erlang, F#, Go, Groovy, Java, JavaScript, Julia, Kotlin, Perl, PHP, Python, R, Ruby, Rust, Scala, Visual Basic, Zig). Updated toctree to include testing reference.
Handbook Navigation Restructuring docs/handbook/index.md	Reorganized toctree entries: added Solutions, Ingestion, Integrate, and Feature references with reordered sequence; removed Topic entry from navigation hierarchy.
Integrate Section Consolidation docs/integrate/category/overview.md, docs/integrate/index.md	Removed Software Testing section from category overview and trimmed Machine Learning details to single-line summary. Updated glob pattern from **/index to */index and added new toctree section linking to category/overview with introductory text.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• Driver: Improve section about Java #402: Modifies docs/connect/index.md for Java driver cards and Software Testing integration content
• Remove redundant index pages #538: Restructures docs/handbook/index.md toctree entries and navigation hierarchy
• Machine learning: Rework and relocate section #314: Modifies docs/integrate/category/overview.md Machine Learning content and section cleanup

Suggested labels

reorganize, refactoring, cross linking

Suggested reviewers

• kneth
• bmunkholm
• surister

Poem

🐰 A rabbit hops through docs so grand,
Twenty drivers now expand the land,
Handbook reorganized with care,
Categories pruned and placed with flair,
Navigation blooms, connections shine! 📚✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly references primary navigation improvements and includes a version/date identifier, directly matching the changeset which restructures navigation across multiple documentation files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	The pull request description clearly relates to the changeset, explaining navigation structure improvements including moving Software Testing to Connect, dissolving Topics section, and relocating items within Integrations.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch toc-202602a

---

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]

Perhaps move the "By category" up to the top, perhaps even enumerate them directly?

And then the long index afterwards?

[amotl]

Sure, why not.

• Integrations: Move reference to "categories" page to the top #544

[bmunkholm]

Great step, and in itself a good valid improvement.

More needs done with the integrations as the TOC index is simply too long. But let's leave that for another PR and this focusing on dissolving the "Topic" 👍.

Optional: remove Rockset migration entirely? Likely no one is left to migrate.

[bmunkholm]

I've merged so I can build on top of this. We can always fix some of the suggestions I had later.

[amotl]

Perhaps move the "By category" up to the top?

• Integrations: Move reference to "categories" page to the top #544

Optional: remove Rockset migration entirely? Likely no one is left to migrate.

• Warehouse Migrations: Hide content until section will be re-populated #545