4 files changed, 68 insertions, 0 deletions
diff --git a/doc/build/changelog/unreleased_20/7122.rst b/doc/build/changelog/unreleased_20/7122.rst
new file mode 100644
index 000000000..6606f6bef
--- /dev/null
+++ b/doc/build/changelog/unreleased_20/7122.rst
@@ -0,0 +1,16 @@
+.. change::
+    :tags: change, engine
+    :tickets: 7122
+
+    Some small API changes regarding engines and dialects:
+
+    * The :meth:`.Dialect.set_isolation_level`, :meth:`.Dialect.get_isolation_level`,
+      :meth:
+      dialect methods will always be passed the raw DBAPI connection
+
+    * The :class:`.Connection` and :class:`.Engine` classes no longer share a base
+      ``Connectable`` superclass, which has been removed.
+
+    * Added a new interface class :class:`.PoolProxiedConnection` - this is the
+      public facing interface for the familiar :class:`._ConnectionFairy`
+      class which is nonetheless a private class.
diff --git a/doc/build/core/internals.rst b/doc/build/core/internals.rst
index aa760073a..9a19ccc13 100644
--- a/doc/build/core/internals.rst
+++ b/doc/build/core/internals.rst
@@ -13,6 +13,18 @@ Some key internal constructs are listed here.
 .. autoclass:: sqlalchemy.engine.Compiled
     :members:
 
+.. autoclass:: sqlalchemy.engine.interfaces.DBAPIConnection
+    :members:
+    :undoc-members:
+
+.. autoclass:: sqlalchemy.engine.interfaces.DBAPICursor
+    :members:
+    :undoc-members:
+
+.. autoclass:: sqlalchemy.engine.interfaces.DBAPIType
+    :members:
+    :undoc-members:
+
 .. autoclass:: sqlalchemy.sql.compiler.DDLCompiler
     :members:
     :inherited-members:
diff --git a/doc/build/core/pooling.rst b/doc/build/core/pooling.rst
index 3e13d9ab9..f6eb7c405 100644
--- a/doc/build/core/pooling.rst
+++ b/doc/build/core/pooling.rst
@@ -569,6 +569,9 @@ API Documentation - Available Pool Implementations
 
 .. autoclass:: StaticPool
 
+.. autoclass:: PoolProxiedConnection
+    :members:
+
 .. autoclass:: _ConnectionFairy
     :members:
 
diff --git a/doc/build/core/reflection.rst b/doc/build/core/reflection.rst
index ec9073138..f91a7453e 100644
--- a/doc/build/core/reflection.rst
+++ b/doc/build/core/reflection.rst
@@ -351,6 +351,43 @@ database is also available. This is known as the "Inspector"::
     :members:
     :undoc-members:
 
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedColumn
+    :members:
+    :inherited-members: dict
+
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedComputed
+    :members:
+    :inherited-members: dict
+
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedCheckConstraint
+    :members:
+    :inherited-members: dict
+
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedForeignKeyConstraint
+    :members:
+    :inherited-members: dict
+
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedIdentity
+    :members:
+    :inherited-members: dict
+
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedIndex
+    :members:
+    :inherited-members: dict
+
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedPrimaryKeyConstraint
+    :members:
+    :inherited-members: dict
+
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedUniqueConstraint
+    :members:
+    :inherited-members: dict
+
+.. autoclass:: sqlalchemy.engine.interfaces.ReflectedTableComment
+    :members:
+    :inherited-members: dict
+
+
 .. _metadata_reflection_dbagnostic_types:
 
 Reflecting with Database-Agnostic Types