README: Reflect new styles "learning path" vs. "reference material"

[amotl]

About

Improve "What's inside" conveyance in README.

Details

Naming things: s/Guide/Handbook/

References

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

[coderabbitai]

Walkthrough

Rebranded documentation from “CrateDB Guide” to “CrateDB Handbook,” updated navigation labels and links to reflect “Learning path” and “Reference material,” adjusted directory naming in text, refreshed external/internal references, revised badges, and made minor stylistic edits and additions in the contributing and metadata sections.

Changes

Cohort / File(s)	Change Summary
Docs rebranding and navigation updates README.md	Renamed guide to handbook, replaced navigation labels to “Learning path” and “Reference material,” updated internal/external links (e.g., Reference Manual, Authoring Guide path), adjusted described folder structure (howto, tutorial, admin, solution), refreshed CI badges, and minor wording/formatting and contributing updates.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• Refine "home" and "connect" entry point pages #237 — Similar edits to README and docs entry points, restructuring headings and navigation labels.
• Index and Topics: Improve guidance #369 — Updates to handbook index and navigation/cards aligning with handbook naming.
• Getting started: Rework whole section #232 — Navigation and internal link refactors parallel to this reorganization.

Suggested labels

guidance, refactoring, maintenance

Suggested reviewers

• bmunkholm
• kneth
• surister

Poem

I thump my paws: a handbook’s born,
Paths to learn and refs to adorn.
Links hop neat in tidy rows,
Badges gleam where CI glows.
In burrows of docs, I nibble and cheer—
Guide to handbook, crystal clear! 🐇✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title Check	✅ Passed	The title clearly identifies that the README is being updated to reflect the new section styles “learning path” versus “reference material,” which aligns with a key aspect of the changeset and is neither vague nor off-topic. Although it does not explicitly mention the rename from “Guide” to “Handbook,” it still captures a substantive part of the update.
Description Check	✅ Passed	The description succinctly explains that the pull request improves the “What’s inside” section of the README and renames occurrences of “Guide” to “Handbook,” which directly corresponds to the documented changes.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch readme-update-layout

---

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]

Thanks for reflecting what we currently have.
I foresee updates to this, but it's great to reflect current state.