Doc tweaks.

Author: anthony-tuininga

doc/src/release_notes.rst

@@ -22,6 +22,9 @@ Thin Mode Changes
 #)  Emulate support for :meth:`Queue.deqmany()` with JSON payloads when using
     Oracle Database 21c by internally calling :meth:`Queue.deqone()` as many
     times as needed.
+#)  Pooled connections that are no longer needed are now closed normally if
+    possible instead of simply having the socket disconnected
+    (`issue 393 <https://github.com/oracle/python-oracledb/issues/393>`__).
 #)  Fixed bug when a connection pool internally makes an attempt to ping a
     closed connection
     (`issue 482 <https://github.com/oracle/python-oracledb/issues/482>`__).
@@ -33,11 +36,8 @@ Thin Mode Changes
     ``https_proxy`` parameter can successfully perform name resolution.
 #)  Fixed bug resulting in explicit request boundaries to aid planned database
     maintenance not being sent when using connection pools with asyncio.
-#)  Pooled connections that are no longer needed are now closed normally if
-    possible instead of simply having the socket disconnected
-    (`issue 393 <https://github.com/oracle/python-oracledb/issues/393>`__).
 #)  Fixed bug resulting in ``TypeError`` when using
-    :attr:`DeqOptions.correlation`` for buffered delivery mode.
+    :attr:`DeqOptions.correlation` for buffered delivery mode.
 
 Thick Mode Changes
 ++++++++++++++++++
@@ -54,8 +54,6 @@ Thick Mode Changes
 Common Changes
 ++++++++++++++
 
-#)  Added parameter ``pool_name`` to connection and pool creation methods to
-    support Oracle Database 23ai multi-pool :ref:`drcp`.
 #)  Added Instance Principal authentication support when using
     :ref:`OCI Cloud Native Authentication <cloudnativeauthoci>`.
 #)  Improvements to :ref:`data frames <dataframeformat>`:
@@ -65,16 +63,18 @@ Common Changes
     - Fixed bug on Windows when fetching dates prior to 1970 and after 2038
       (`issue 483 <https://github.com/oracle/python-oracledb/issues/483>`__).
 
+#)  Added parameter ``pool_name`` to connection and pool creation methods to
+    support Oracle Database 23ai multi-pool :ref:`drcp`.
 #)  Use GitHub Arm Linux runner for builds. Supplied by wojiushixiaobai
     (`PR 496 <https://github.com/oracle/python-oracledb/pull/496>`__).
 #)  Fix bug with GitHub build action merge artifacts step
     (`issue 495 <https://github.com/oracle/python-oracledb/issues/495>`__).
 #)  Error ``DPY-2064: parameter 'max' should be greater than or equal to
     parameter 'min'`` is now raised when a call to
     :meth:`oracledb.create_pool()`, :meth:`oracledb.create_pool_async()`
-    or :meth:`oracledb.PoolParams()` is made with parameter "max" less than the
-    parameter "min". Previously python-oracledb Thin mode did not raise an
-    error and python-oracledb Thick mode raised the exception
+    or :meth:`oracledb.PoolParams()` is made with parameter ``max`` less than
+    the parameter ``min``. Previously python-oracledb Thin mode did not raise
+    an error and python-oracledb Thick mode raised the exception
     ``ORA-24413: Invalid number of sessions specified``.
 #)  Improved the test suite and documentation.
 

doc/src/user_guide/connection_handling.rst

@@ -3084,7 +3084,8 @@ specifying a class name, you can call:
                                 cclass="MYAPP")
 
 If ``cclass`` is not set, then the pooled server sessions will not be reused
-optimally, and the DRCP statistic views may record large values for NUM_MISSES.
+optimally, and the :ref:`DRCP statistic views <monitoringdrcp>` may record
+large values for NUM_MISSES.
 
 **DRCP Connection Purity**
 

tests/README.md

@@ -9,10 +9,14 @@ This directory contains the test suite for python-oracledb.
 
         python create_schema.py
 
-2.  Run the test suite by issuing the following command in the top-level
+2.  Install tox:
+
+        python -m pip install tox
+
+3.  Run the test suite by issuing the following command in the top-level
     directory of your oracledb installation:
 
-        tox
+        python -m tox
 
     This will build the module in an independent environment and run the test
     suite using the module that was just built in that environment.
@@ -25,7 +29,7 @@ This directory contains the test suite for python-oracledb.
 
         python test_1000_module.py
 
-3.  After running the test suite, the schemas can be dropped by running the
+4.  After running the test suite, the schemas can be dropped by running the
     Python script [drop_schema.py][3]. The script requires administrative
     privileges and will prompt for these credentials as well as the names of
     the schemas that will be dropped, unless a number of environment variables
@@ -34,12 +38,12 @@ This directory contains the test suite for python-oracledb.
 
         python drop_schema.py
 
-4.  Enable tests that require extra configuration
+5.  Enable tests that require extra configuration
 
     The following test(s) are automatically skipped if their required
     environment variable(s) and setup is not available.
 
-    4.1  test_5000_externalauth.py
+    5.1  test_5000_externalauth.py
 
          This test aims to test the usage of external authentication.