Skip to content

Conversation

@cofin
Copy link
Member

@cofin cofin commented Oct 9, 2025

Summary

Redesign of the adapters documentation page

  • Organized by database: Each database (PostgreSQL, SQLite, MySQL, DuckDB, BigQuery, Oracle) has its own section with adapters listed underneath, plus a Cross-Database section for ADBC
  • Removed comparison matrix: Eliminated "when to choose each driver" recommendations
  • Added comprehensive details for each adapter:
    • Official homepage and PyPI links
    • Sync/async support capabilities
    • Connection pooling type (native, custom, or none)
    • Parameter binding style
    • Special features (pgvector, extensions, Arrow-native, etc.)
    • Known limitations
    • Installation examples
    • Configuration examples
  • Factual language only: Removed all marketing jargon and performance claims
  • Architecture documentation: Added sections on common patterns, parameter binding conversion, and pooling types

Changes

  • docs/reference/adapters.rst: Complete rewrite (765 insertions, 210 deletions)

- Organize adapters by database (PostgreSQL, SQLite, MySQL, DuckDB, BigQuery, Oracle, Cross-Database)
- Remove comparison matrix and "when to choose" recommendations
- Add official homepage and PyPI links for each adapter
- Document sync/async support, pooling types, and parameter styles
- Highlight special features (pgvector, extensions, Arrow-native, etc.)
@cofin cofin merged commit 1c720b2 into main Oct 9, 2025
10 checks passed
@cofin cofin deleted the driver-compare branch October 9, 2025 01:50
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.

2 participants