Make driver projects use a standalone primary navigation, and remove from main TOC #689
+11
−29
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
amotl
force-pushed
the
drivers-standalone
branch
from
7163478 to
1248e59
Compare
amotl
commented
Jan 15, 2026
amotl
force-pushed
the
drivers-standalone
branch
from
1248e59 to
89d040b
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
About
This patch makes the primary navigation of all driver projects standalone, so we no longer need to take any TOC assembly concerns into consideration on them, for the benefits of better detanglement. In this spirit, the patch tries another attempt to remove the dedicated driver projects from the main TOC, in order to exclusively make them part of a larger assembly of connectivity options.
Rationale
After CrateDB received PostgreSQL compatibility, it gained a way larger surface of connectivity options, which is a good thing. At the same time, our legacy drivers became less maintained, which is natural. In this spirit, we shouldn't present them any longer on the main stage, but just refer to them within a larger gallery where other more optimal connectivity options exist, mostly through drivers and adapters which are NOT from our pen.
Outlook
This gives us the freedom to shift the focus of proper guidance to the refurbished drivers section which offers more attractive connectivity options / enumerates them within a broader context.
References
Status / Preview
Tested on two downstream projects at crate/crate-npgsql#78 (preview) and crate/crate-jdbc#470 (preview). "All database drivers" links back to the section root.