Skip to content

docs: reorganize docs to highlight tools and drivers - #4525

Merged
lidavidm merged 111 commits into
apache:mainfrom
amoeba:docs/docs-rework
Jul 20, 2026
Merged

lidavidm merged 111 commits into
apache:mainfrom
amoeba:docs/docs-rework

Conversation

@amoeba

@amoeba amoeba commented Jul 14, 2026 •

Copy link
Copy Markdown
Member

This is a major reorganization and rethinking of the ADBC docs to catch them up with what's happening across the ADBC ecosystem.

The key changes are:

  • New, simpler landing page focusing on the core questions users will have (what drivers are available, how do I connect with one, how do I write a new driver)
  • New sidebar structure that starts by grouping pages into one of two major categories: Connecting or Writing Drivers
  • New Drivers page that covers the third-party driver ecosystem which has grown quite a lot. Includes talking about dbc, the ADBC Driver Foundry, third-party drivers offered by Columnar
  • New Tools & Integrations page covering the cool ecosystem stuff like pandas/polars/R/etc
  • Now uses the term "Client Library" over Driver Manager in many places as this is conceptually more simple. No packages were renamed so the term Driver Manager is still valid and used in the docs.
  • Language-specific docs now more consistently load drivers by manifest rather than driver-specific packages.
  • New page on Writing Drivers
  • New page on Connection Profiles
  • A small but updated C# page
  • Updated Glossary

TODOs before merge (if possible):

Closes #4233
Closes #4454

@amoeba
amoeba force-pushed the docs/docs-rework branch from cdc7bec to b287363 Compare July 14, 2026 23:20
Comment thread docs/source/driver/authoring.rst Outdated
Comment thread docs/source/driver/authoring.rst Outdated
Comment thread docs/source/python/quickstart.rst Outdated
Comment thread docs/source/csharp/quickstart.rst Outdated
Comment thread docs/source/java/quickstart.rst Outdated
Comment thread docs/source/client_libraries.rst
Comment thread docs/source/integrations.rst
amoeba and others added 2 commits July 14, 2026 17:58
Co-authored-by: David Li <li.davidm96@gmail.com>
Co-authored-by: David Li <li.davidm96@gmail.com>
Comment thread docs/source/client_libraries.rst Outdated
Comment thread docs/source/driver/alt1.rst Outdated
Comment thread docs/source/integrations.rst Outdated
Comment thread docs/source/integrations.rst
Comment thread docs/source/integrations.rst
Comment thread docs/source/index.rst
Comment thread docs/source/index.rst Outdated
Comment thread docs/source/index.rst
Comment thread docs/source/driver/index.rst
Comment thread docs/source/index.rst Outdated
Comment thread docs/source/connection_profiles.rst
Comment thread docs/source/driver/authoring.rst Outdated
@ianmcook

ianmcook commented Jul 17, 2026 •

Copy link
Copy Markdown
Member

Should we update the driver installation instructions the Go README to be more consistent with the other language quickstarts updated here?
https://pkg.go.dev/github.com/apache/arrow-adbc/go/adbc#section-readme

EDIT: Done in 1badce5

@ianmcook

Copy link
Copy Markdown
Member

Should we update the driver installation instructions the Go README to be more consistent with the other language quickstarts updated here? https://pkg.go.dev/github.com/apache/arrow-adbc/go/adbc#section-readme

Done in 1badce5

@lidavidm
lidavidm merged commit fddc148 into apache:main Jul 20, 2026
80 of 83 checks passed
@lidavidm lidavidm added this to the ADBC Libraries 24 milestone Jul 22, 2026
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.

docs: document drivername:// URI convention and behaviors docs: document third-party ecosystem (tools, drivers)

4 participants