Reorder release notes for consistency.

Author: anthony-tuininga

doc/src/release_notes.rst

@@ -15,24 +15,25 @@ Thin Mode Changes
 
 #)  Added support for asyncio
     (`issue 6 <https://github.com/oracle/python-oracledb/issues/6>`__).
-#)  Added support for an Oracle Database 23c JSON feature allowing for field
-    names with more than 255 UTF-8 encoded bytes.
-#)  Added support for an Oracle Database 23c JSON feature improving JSON
-    storage usage.
 #)  Added parameter :attr:`ConnectParams.sdu` for configuring the Session Data
     Unit (SDU) size for sizing internal buffers used for tuning communication
     with the database.
+#)  Added parameter :data:`ConnectParams.ssl_context` to modify the SSL context
+    used when connecting via TLS
+    (`issue 259 <https://github.com/oracle/python-oracledb/issues/259>`__).
+#)  Added support for an Oracle Database 23c JSON feature allowing field names
+    with more than 255 UTF-8 encoded bytes.
+#)  Added support for the ``FAILOVER`` clause in full connect descriptors.
 #)  Fixed bug in detecting the current time zone
     (`issue 257 <https://github.com/oracle/python-oracledb/issues/257>`__).
-#)  Added connection establishment parameter :data:`ConnectParams.ssl_context`
-    (`issue 259 <https://github.com/oracle/python-oracledb/issues/259>`__).
 #)  Fixed bug in handling database response in certain unusual circumstances.
 #)  Fixed bug in handling exceptions raised during connection establishment.
 #)  Fixed bug in identifying bind variables in SQL statements containing
     multiple line comments with multiple asterisks before the closing slash.
-#)  Added support for the ``FAILOVER`` clause in full connect descriptors.
 #)  A more meaningful error is raised when the wrong type of data is passed to
     :meth:`LOB.write()`.
+#)  Internal change to support an Oracle Database 23c JSON feature improving
+    JSON storage usage.
 #)  Internal change to ensure that all connections in a pool have been closed
     gracefully before the pool is closed.
 #)  Internal changes to improve handling of the network protocol between
@@ -48,7 +49,12 @@ Thick Mode Changes
 Common Changes
 ++++++++++++++
 
-#)  Dropped support for Python 3.6 and added support for Python 3.12.
+#)  Dropped support for Python 3.6.
+#)  The attribute ``oracledb.__future__.old_json_col_as_obj`` no longer needs to
+    be set to fetch JSON data from VARCHAR2 and LOB columns (which have the "IS
+    JSON" constraint) as objects, similar to fetching Oracle Database 21c JSON
+    columns. An :ref:`output type handler <outputtypehandlers>` can be used if
+    the previous default behavior of fetching as VARCHAR2 or LOB is desired.
 #)  Added property :attr:`Cursor.warning` for database warnings (such as PL/SQL
     compilation warnings) generated by calls to :meth:`Cursor.execute()` or
     :meth:`Cursor.executemany()`.
@@ -58,43 +64,42 @@ Common Changes
     :attr:`Connection.db_domain`, :attr:`Connection.db_name`,
     :attr:`Connection.max_open_cursors`, :attr:`Connection.service_name`
     and :attr:`Connection.transaction_in_progress`.
-#)  Added attributes :data:`FetchInfo.domain_schema`,
+#)  Added property :data:`Connection.proxy_user` to show the name of the user
+    which was used as a proxy when connecting (`issue 250
+    <https://github.com/oracle/python-oracledb/issues/250>`__).
+#)  Added properties :data:`FetchInfo.domain_schema`,
     :data:`FetchInfo.domain_name` and :data:`FetchInfo.annotations` for the
     `SQL domain <https://docs.oracle.com/en/database/oracle/oracle-database/
     23/sqlrf/create-domain.html#GUID-17D3A9C6-D993-4E94-BF6B-CACA56581F41>`__
-    and `annotations <https://docs.oracle.com/en/database/oracle/oracle-database/
-    23/sqlrf/annotations_clause.html#GUID-1AC16117-BBB6-4435-8794-2B99F8F68052>`__
+    and `annotations <https://docs.oracle.com/en/database/oracle/
+    oracle-database/23/sqlrf/annotations_clause.html#
+    GUID-1AC16117-BBB6-4435-8794-2B99F8F68052>`__
     associated with columns that are being fetched. SQL domains and annotations
     require Oracle Database 23c. If using python-oracledb Thick mode, Oracle
     Client 23c is also required.
-#)  Added attribute :data:`Connection.proxy_user` as requested
-    (`issue 250 <https://github.com/oracle/python-oracledb/issues/250>`__).
 #)  Added type :data:`~oracledb.DB_TYPE_XMLTYPE` to represent data of type
     ``SYS.XMLTYPE`` in the database. Previously the value of
     :data:`FetchInfo.type_code` for data of this type was
     :data:`~oracledb.DB_TYPE_LONG` in Thick mode and
     :data:`~oracledb.DB_TYPE_OBJECT` in Thin mode.
-#)  Attribute and element values of :ref:`Oracle Object <dbobject>`
-    instances that are numbers are now returned as integers if the precision
-    and scale allow for it -- in the same way that numbers are fetched from the
+#)  Attribute and element values of :ref:`Oracle Object <dbobject>` instances
+    that are numbers are now returned as integers if the precision and scale
+    allow for it. This is the same way that numbers are fetched from the
     database
     (`issue 99 <https://github.com/oracle/python-oracledb/issues/99>`__).
+#)  Errors that have entries in the
+    :ref:`troubleshooting documentation <troubleshooting>` now have links to
+    that documentation shown in the message text.
 #)  Fixed bug with binding boolean values with Oracle Database 23c
     (`issue 263 <https://github.com/oracle/python-oracledb/issues/263>`__).
-#)  Fixed bug with getting unknown attributes from DbObject instances.
+#)  Fixed bug with getting unknown attributes from :ref:`Oracle Object
+    <dbobject>` instances.
 #)  Error ``DPY-4029: errors in array DML exceed 65535`` is now raised when the
     number of batch errors exceeds 65535 when calling
     :meth:`Cursor.executemany()` with the parameter ``batcherrors`` set to the
     value ``True``. Note that in thick mode this error is not raised unless the
     number of batch errors is a multiple of 65536; instead, the number of batch
     errors returned is modulo 65536.
-#)  Errors that have entries in the
-    :ref:`troubleshooting documentation <troubleshooting>` now have links to
-    that documentation included in the message text.
-#)  The attribute ``oracledb.__future__.old_json_col_as_obj`` no longer needs
-    to be set in order to fetch JSON data found in VARCHAR2 and LOB columns in
-    the same way that JSON columns (which requires Oracle Database 21c or
-    higher) are fetched.
 #)  Black is now used to format Python code and ruff to lint Python code.
 
 
@@ -145,7 +150,7 @@ Common Changes
     statements with the noted invalid syntax.  Previously, thick mode gave
     ``ORA-1756`` or ``ORA-1740``, respectively, while thin mode did not throw
     an error.
-#)  Added missing ">" to repr() of SodaDatabase.
+#)  Added missing ">" to ``repr()`` of :ref:`sodadb`.
 
 
 oracledb 1.4.0 (August 2023)