Skip to content

Conversation

@amotl
Copy link
Member

@amotl amotl commented Jan 14, 2026

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.

image

@amotl amotl force-pushed the drivers-standalone branch from 7163478 to 1248e59 Compare January 15, 2026 00:05
@amotl amotl requested review from bmunkholm and kneth January 15, 2026 00:09
@amotl amotl marked this pull request as ready for review January 15, 2026 00:10
@amotl amotl force-pushed the drivers-standalone branch from 1248e59 to 89d040b Compare January 15, 2026 00:20
@bmunkholm
Copy link
Contributor

A few thoughts - nothing blocking:

  1. Should first TOC be "Documentation" or the name of the driver? Do we even need that level? If we prefer not to have that, as it's not really that useful?, we can use the technique from the guide to have multiple entries in the root.
  2. Should we add the two links Community & Support at the left TOC at the bottom?

@amotl
Copy link
Member Author

amotl commented Jan 19, 2026

a) You can easily change or extend everything at your disposal. b) I prefer not to obfuscate too much by using special techniques, as our journey was originally directed towards getting rid of them.

@amotl amotl merged commit dfab271 into main Jan 19, 2026
8 checks passed
@amotl amotl deleted the drivers-standalone branch January 19, 2026 18:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants