fix tox -e docs issues

Author: beijiez

instrumentation/opentelemetry-instrumentation-mysql/src/opentelemetry/instrumentation/mysql/__init__.py

@@ -92,11 +92,11 @@ def instrument_connection(self, connection, tracer_provider=None):
         """Enable instrumentation in a MySQL connection.
 
         Args:
-            connection (mysql.connector.Connection):
+            connection:
                 The existing MySQL connection instance to instrument. This connection is typically
                 obtained through `mysql.connector.connect()` and is instrumented to collect telemetry
                 data about database interactions.
-            tracer_provider (TracerProvider, optional):
+            tracer_provider:
                 An optional `TracerProvider` instance to use for tracing. If not provided, the globally
                 configured tracer provider will be automatically used.
 

instrumentation/opentelemetry-instrumentation-mysqlclient/src/opentelemetry/instrumentation/mysqlclient/__init__.py

@@ -63,8 +63,8 @@
             "db_driver": True,
             "mysql_client_version": True,
             "driver_paramstyle": False
-            }
-        )
+        }
+    )
     cursor = instrumented_cnx.cursor()
     cursor.execute("INSERT INTO test (testField) VALUES (123)"
     instrumented_cnx.commit()
@@ -177,17 +177,17 @@ def instrument_connection(
         """Enable instrumentation in a mysqlclient connection.
 
         Args:
-            connection (MySQLdb.connect or Connection object):
+            connection:
                 The MySQL connection instance to instrument. This connection is typically
                 created using `MySQLdb.connect()` and needs to be wrapped to collect telemetry.
-            tracer_provider (TracerProvider, optional):
+            tracer_provider:
                 A custom `TracerProvider` instance to be used for tracing. If not specified,
                 the globally configured tracer provider will be used.
-            enable_commenter (bool, optional):
+            enable_commenter:
                 A flag to enable the OpenTelemetry SQLCommenter feature. If set to `True`,
                 SQL queries will be enriched with contextual information (e.g., database client details).
                 Default is `None`.
-            commenter_options (dict, optional):
+            commenter_options:
                 A dictionary of configuration options for SQLCommenter. This allows you to customize
                 metadata appended to queries. Possible options include:
                     - `db_driver`: Adds the database driver name and version.
@@ -196,8 +196,6 @@ def instrument_connection(
                     - `mysql_client_version`: Adds the MySQL client version.
                     - `driver_paramstyle`: Adds the parameter style.
                     - `opentelemetry_values`: Includes traceparent values.
-                Refer to *SQLCommenter Configurations* above for more information
-
         Returns:
             An instrumented MySQL connection with OpenTelemetry support enabled.
         """

instrumentation/opentelemetry-instrumentation-psycopg2/src/opentelemetry/instrumentation/psycopg2/__init__.py

@@ -103,6 +103,7 @@
     cursor.execute("INSERT INTO test (testField) VALUES (123)")
     cursor.close()
     instrumented_cnx.close()
+
 API
 ---
 """

instrumentation/opentelemetry-instrumentation-pymysql/src/opentelemetry/instrumentation/pymysql/__init__.py

@@ -179,16 +179,16 @@ def instrument_connection(
         """Enable instrumentation in a PyMySQL connection.
 
         Args:
-            connection (pymysql.Connection):
+            connection:
                 The existing PyMySQL connection instance that needs to be instrumented.
                 This connection was typically created using `pymysql.connect()` and is wrapped with OpenTelemetry tracing.
-            tracer_provider (TracerProvider, optional):
+            tracer_provider:
                 An optional `TracerProvider` instance that specifies which tracer provider should be used.
                 If not provided, the globally configured OpenTelemetry tracer provider is automatically applied.
-            enable_commenter (bool, optional):
+            enable_commenter:
                 A flag to enable the SQL Commenter feature. If `True`, query logs will be enriched with additional
                 contextual metadata (e.g., database version, traceparent IDs, driver information).
-            commenter_options (dict, optional):
+            commenter_options:
                 A dictionary containing configuration options for the SQL Commenter feature.
                 You can specify various options, such as enabling driver information, database version logging,
                 traceparent propagation, and other customizable metadata enhancements.

instrumentation/opentelemetry-instrumentation-sqlite3/src/opentelemetry/instrumentation/sqlite3/__init__.py

@@ -44,6 +44,7 @@
     cursor.execute("SELECT * FROM test")
     cursor.close()
     instrumented_connection.close()
+
 API
 ---
 """
@@ -111,7 +112,7 @@ def instrument_connection(
                 the current globally configured one is used.
 
         Returns:
-            SQLite3Connection: An instrumented SQLite connection that supports
+            An instrumented SQLite connection that supports
             telemetry for tracing database operations.
 
         Notes: