docs: style Python API reference docs

dgarcia360 · dkropachev · commit c71835aeb024 · 2025-11-27T11:21:20.000-04:00
diff --git a/docs/api/cassandra.rst b/docs/api/cassandra.rst
@@ -1,5 +1,7 @@
-:mod:`cassandra` - Exceptions and Enums
-=======================================
+cassandra
+=========
+
+Exceptions and Enums
 
 .. module:: cassandra
 
diff --git a/docs/api/cassandra/auth.rst b/docs/api/cassandra/auth.rst
@@ -1,5 +1,7 @@
-``cassandra.auth`` - Authentication
-===================================
+cassandra.auth
+==============
+
+Authentication
 
 .. module:: cassandra.auth
 
diff --git a/docs/api/cassandra/cluster.rst b/docs/api/cassandra/cluster.rst
@@ -1,5 +1,7 @@
-``cassandra.cluster`` - Clusters and Sessions
-=============================================
+cassandra.cluster
+=================
+
+Clusters and Sessions
 
 .. module:: cassandra.cluster
 
diff --git a/docs/api/cassandra/concurrent.rst b/docs/api/cassandra/concurrent.rst
@@ -1,5 +1,7 @@
-``cassandra.concurrent`` - Utilities for Concurrent Statement Execution
-=======================================================================
+cassandra.concurrent
+====================
+
+Utilities for Concurrent Statement Execution
 
 .. module:: cassandra.concurrent
 
diff --git a/docs/api/cassandra/connection.rst b/docs/api/cassandra/connection.rst
@@ -1,5 +1,7 @@
-``cassandra.connection`` - Low Level Connection Info
-====================================================
+cassandra.connection
+====================
+
+Low Level Connection Info
 
 .. module:: cassandra.connection
 
diff --git a/docs/api/cassandra/cqlengine/columns.rst b/docs/api/cassandra/cqlengine/columns.rst
@@ -1,5 +1,7 @@
-``cassandra.cqlengine.columns`` - Column types for object mapping models
-========================================================================
+cassandra.cqlengine.columns
+===========================
+
+Column types for object mapping models
 
 .. module:: cassandra.cqlengine.columns
 
diff --git a/docs/api/cassandra/cqlengine/connection.rst b/docs/api/cassandra/cqlengine/connection.rst
@@ -1,5 +1,7 @@
-``cassandra.cqlengine.connection`` - Connection management for cqlengine
-========================================================================
+cassandra.cqlengine.connection
+==============================
+
+Connection management for cqlengine
 
 .. module:: cassandra.cqlengine.connection
 
diff --git a/docs/api/cassandra/cqlengine/management.rst b/docs/api/cassandra/cqlengine/management.rst
@@ -1,5 +1,7 @@
-``cassandra.cqlengine.management`` - Schema management for cqlengine
-========================================================================
+cassandra.cqlengine.management
+==============================
+
+Schema management for cqlengine
 
 .. module:: cassandra.cqlengine.management
 
diff --git a/docs/api/cassandra/cqlengine/models.rst b/docs/api/cassandra/cqlengine/models.rst
@@ -1,5 +1,7 @@
-``cassandra.cqlengine.models`` - Table models for object mapping
-================================================================
+cassandra.cqlengine.models
+==========================
+
+Table models for object mapping
 
 .. module:: cassandra.cqlengine.models
 
diff --git a/docs/api/cassandra/cqlengine/query.rst b/docs/api/cassandra/cqlengine/query.rst
@@ -1,5 +1,7 @@
-``cassandra.cqlengine.query`` - Query and filter model objects
-=================================================================
+cassandra.cqlengine.query
+=========================
+
+Query and filter model objects
 
 .. module:: cassandra.cqlengine.query
 
diff --git a/docs/api/cassandra/cqlengine/usertype.rst b/docs/api/cassandra/cqlengine/usertype.rst
@@ -1,5 +1,7 @@
-``cassandra.cqlengine.usertype`` - Model classes for User Defined Types
-=======================================================================
+cassandra.cqlengine.usertype
+============================
+
+Model classes for User Defined Types
 
 .. module:: cassandra.cqlengine.usertype
 
diff --git a/docs/api/cassandra/decoder.rst b/docs/api/cassandra/decoder.rst
@@ -1,5 +1,7 @@
-``cassandra.decoder`` - Data Return Formats
-===========================================
+cassandra.decoder
+=================
+
+Data Return Formats
 
 .. module:: cassandra.decoder
 
diff --git a/docs/api/cassandra/encoder.rst b/docs/api/cassandra/encoder.rst
@@ -1,5 +1,7 @@
-``cassandra.encoder`` - Encoders for non-prepared Statements
-============================================================
+cassandra.encoder
+=================
+
+Encoders for non-prepared Statements
 
 .. module:: cassandra.encoder
 
diff --git a/docs/api/cassandra/io/asyncioreactor.rst b/docs/api/cassandra/io/asyncioreactor.rst
@@ -1,5 +1,7 @@
-``cassandra.io.asyncioreactor`` - ``asyncio`` Event Loop
-=====================================================================
+cassandra.io.asyncioreactor
+===========================
+
+``asyncio`` Event Loop
 
 .. module:: cassandra.io.asyncioreactor
 
diff --git a/docs/api/cassandra/io/asyncorereactor.rst b/docs/api/cassandra/io/asyncorereactor.rst
@@ -1,5 +1,7 @@
-``cassandra.io.asyncorereactor`` - ``asyncore`` Event Loop
-==========================================================
+cassandra.io.asyncorereactor
+============================
+
+``asyncore`` Event Loop
 
 .. module:: cassandra.io.asyncorereactor
 
diff --git a/docs/api/cassandra/io/eventletreactor.rst b/docs/api/cassandra/io/eventletreactor.rst
@@ -1,5 +1,7 @@
-``cassandra.io.eventletreactor`` - ``eventlet``-compatible Connection
-=====================================================================
+cassandra.io.eventletreactor
+============================
+
+``eventlet``-compatible Connection
 
 .. module:: cassandra.io.eventletreactor
 
diff --git a/docs/api/cassandra/io/geventreactor.rst b/docs/api/cassandra/io/geventreactor.rst
@@ -1,5 +1,7 @@
-``cassandra.io.geventreactor`` - ``gevent``-compatible Event Loop
-=================================================================
+cassandra.io.geventreactor
+==========================
+
+``gevent``-compatible Event Loop
 
 .. module:: cassandra.io.geventreactor
 
diff --git a/docs/api/cassandra/io/libevreactor.rst b/docs/api/cassandra/io/libevreactor.rst
@@ -1,5 +1,7 @@
-``cassandra.io.libevreactor`` - ``libev`` Event Loop
-====================================================
+cassandra.io.libevreactor
+=========================
+
+``libev`` Event Loop
 
 .. module:: cassandra.io.libevreactor
 
diff --git a/docs/api/cassandra/io/twistedreactor.rst b/docs/api/cassandra/io/twistedreactor.rst
@@ -1,5 +1,7 @@
-``cassandra.io.twistedreactor`` - Twisted Event Loop
-====================================================
+cassandra.io.twistedreactor
+===========================
+
+Twisted Event Loop
 
 .. module:: cassandra.io.twistedreactor
 
diff --git a/docs/api/cassandra/metadata.rst b/docs/api/cassandra/metadata.rst
@@ -1,5 +1,7 @@
-``cassandra.metadata`` - Schema and Ring Topology
-=================================================
+cassandra.metadata
+==================
+
+Schema and Ring Topology
 
 .. module:: cassandra.metadata
 
diff --git a/docs/api/cassandra/metrics.rst b/docs/api/cassandra/metrics.rst
@@ -1,5 +1,7 @@
-``cassandra.metrics`` - Performance Metrics
-===========================================
+cassandra.metrics
+=================
+
+Performance Metrics
 
 .. module:: cassandra.metrics
 
diff --git a/docs/api/cassandra/policies.rst b/docs/api/cassandra/policies.rst
@@ -1,5 +1,7 @@
-``cassandra.policies`` - Load balancing and Failure Handling Policies
-=====================================================================
+cassandra.policies
+==================
+
+Load balancing and Failure Handling Policies
 
 .. module:: cassandra.policies
 
diff --git a/docs/api/cassandra/pool.rst b/docs/api/cassandra/pool.rst
@@ -1,5 +1,7 @@
-``cassandra.pool`` - Hosts and Connection Pools
-===============================================
+cassandra.pool
+==============
+
+Hosts and Connection Pools
 
 .. automodule:: cassandra.pool
 
diff --git a/docs/api/cassandra/protocol.rst b/docs/api/cassandra/protocol.rst
@@ -1,5 +1,7 @@
-``cassandra.protocol`` - Protocol Features
-=====================================================================
+cassandra.protocol
+==================
+
+Protocol Features
 
 .. module:: cassandra.protocol
 
diff --git a/docs/api/cassandra/query.rst b/docs/api/cassandra/query.rst
@@ -1,5 +1,7 @@
-``cassandra.query`` - Prepared Statements, Batch Statements, Tracing, and Row Factories
-=======================================================================================
+cassandra.query
+===============
+
+Prepared Statements, Batch Statements, Tracing, and Row Factories
 
 .. module:: cassandra.query
 
diff --git a/docs/api/cassandra/timestamps.rst b/docs/api/cassandra/timestamps.rst
@@ -1,5 +1,7 @@
-``cassandra.timestamps`` - Timestamp Generation
-===============================================
+cassandra.timestamps
+====================
+
+Timestamp Generation
 
 .. module:: cassandra.timestamps
 
diff --git a/docs/api/cassandra/util.rst b/docs/api/cassandra/util.rst
@@ -1,5 +1,7 @@
-``cassandra.util`` - Utilities
-===================================
+cassandra.util
+==============
+
+Utilities
 
 .. automodule:: cassandra.util
     :members: 
diff --git a/docs/api/index.rst b/docs/api/index.rst
@@ -4,7 +4,7 @@ API Documentation
 Core Driver
 -----------
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
 
    cassandra
    cassandra/cluster
