crate · amotl · Mar 31, 2025 · Mar 28, 2025
diff --git a/docs/connect.rst b/docs/connect.rst
@@ -10,7 +10,7 @@ Connect to CrateDB
     `Python Database API Specification v2.0`_ (PEP 249).
 
     For help using the `SQLAlchemy`_ dialect, consult the
-    :ref:`SQLAlchemy dialect documentation <using-sqlalchemy>`.
+    :ref:`SQLAlchemy dialect documentation <sqlalchemy-cratedb:index>`.
 
 .. SEEALSO::
 

diff --git a/docs/index-all.rst b/docs/index-all.rst
@@ -16,7 +16,6 @@ CrateDB Python Client -- all pages
     connect
     query
     blobs
-    sqlalchemy
     data-types
     by-example/index
     other-options
diff --git a/docs/index.rst b/docs/index.rst
@@ -99,7 +99,7 @@ please consult the :ref:`data-types` documentation page.
 Migration Notes
 ===============
 
-The :ref:`CrateDB dialect <using-sqlalchemy>` for `SQLAlchemy`_ is provided
+The :ref:`CrateDB dialect <sqlalchemy-cratedb:index>` for `SQLAlchemy`_ is provided
 by the `sqlalchemy-cratedb`_ package.
 
 If you are migrating from previous versions of ``crate[sqlalchemy]<1.0.0``, you

diff --git a/docs/query.rst b/docs/query.rst
@@ -10,7 +10,7 @@ Query CrateDB
     `Python Database API Specification v2.0`_ (PEP 249).
 
     For help using the `SQLAlchemy`_ dialect, consult
-    :ref:`the SQLAlchemy dialect documentation <using-sqlalchemy>`.
+    :ref:`the SQLAlchemy dialect documentation <sqlalchemy-cratedb:index>`.
 
 .. SEEALSO::
 

diff --git a/docs/sqlalchemy.rst b/docs/sqlalchemy.rst