Docs: improve wording around transaction timeout (#970)

* Docs: improve wording around transaction timeout

Signed-off-by: Grant Lodge <6323995+thelonelyvulpes@users.noreply.github.com>

* Fix capitalization

Signed-off-by: Richard Irons <115992270+RichardIrons-neo4j@users.noreply.github.com>

---------

Signed-off-by: Grant Lodge <6323995+thelonelyvulpes@users.noreply.github.com>
Signed-off-by: Richard Irons <115992270+RichardIrons-neo4j@users.noreply.github.com>

Author: robsdedude

src/neo4j/_async/work/session.py

@@ -468,14 +468,15 @@ async def begin_transaction(
             the transaction timeout in seconds.
             Transactions that execute longer than the configured timeout will
             be terminated by the database.
-            This functionality allows to limit query/transaction execution
-            time.
-            The Specified timeout overrides the default timeout configured in
+            This functionality allows user code to limit query/transaction
+            execution time.
+            The specified timeout overrides the default timeout configured in
             the database using the ``db.transaction.timeout`` setting
             (``dbms.transaction.timeout`` before Neo4j 5.0).
             Values higher than ``db.transaction.timeout`` will be ignored and
-            will fall back to the default for server versions 4.2 to including
-            5.2. The value should not represent a negative duration.
+            will fall back to the default for server versions between 4.2 and
+            5.2 (inclusive).
+            The value should not represent a negative duration.
             A ``0`` duration will make the transaction execute indefinitely.
             :data:`None` will use the default timeout configured on the server.
 

src/neo4j/_sync/work/session.py

@@ -468,14 +468,15 @@ def begin_transaction(
             the transaction timeout in seconds.
             Transactions that execute longer than the configured timeout will
             be terminated by the database.
-            This functionality allows to limit query/transaction execution
-            time.
-            The Specified timeout overrides the default timeout configured in
+            This functionality allows user code to limit query/transaction
+            execution time.
+            The specified timeout overrides the default timeout configured in
             the database using the ``db.transaction.timeout`` setting
             (``dbms.transaction.timeout`` before Neo4j 5.0).
             Values higher than ``db.transaction.timeout`` will be ignored and
-            will fall back to the default for server versions 4.2 to including
-            5.2. The value should not represent a negative duration.
+            will fall back to the default for server versions between 4.2 and
+            5.2 (inclusive).
+            The value should not represent a negative duration.
             A ``0`` duration will make the transaction execute indefinitely.
             :data:`None` will use the default timeout configured on the server.
 

src/neo4j/_work/query.py

@@ -51,14 +51,15 @@ class Query:
         the transaction timeout in seconds.
         Transactions that execute longer than the configured timeout will
         be terminated by the database.
-        This functionality allows to limit query/transaction execution
-        time.
-        The Specified timeout overrides the default timeout configured in
+        This functionality allows user code to limit query/transaction
+        execution time.
+        The specified timeout overrides the default timeout configured in
         the database using the ``db.transaction.timeout`` setting
         (``dbms.transaction.timeout`` before Neo4j 5.0).
         Values higher than ``db.transaction.timeout`` will be ignored and
-        will fall back to the default for server versions 4.2 to including
-        5.2. The value should not represent a negative duration.
+        will fall back to the default for server versions between 4.2 and
+        5.2 (inclusive).
+        The value should not represent a negative duration.
         A ``0`` duration will make the transaction execute indefinitely.
         :data:`None` will use the default timeout configured on the server.
     :type timeout: float | None
@@ -114,14 +115,15 @@ def count_people_tx(tx):
         the transaction timeout in seconds.
         Transactions that execute longer than the configured timeout will
         be terminated by the database.
-        This functionality allows to limit query/transaction execution
-        time.
-        The Specified timeout overrides the default timeout configured in
+        This functionality allows user code to limit query/transaction
+        execution time.
+        The specified timeout overrides the default timeout configured in
         the database using the ``db.transaction.timeout`` setting
         (``dbms.transaction.timeout`` before Neo4j 5.0).
         Values higher than ``db.transaction.timeout`` will be ignored and
-        will fall back to the default for server versions 4.2 to including
-        5.2. The value should not represent a negative duration.
+        will fall back to the default for server versions between 4.2 and
+        5.2 (inclusive).
+        The value should not represent a negative duration.
         A ``0`` duration will make the transaction execute indefinitely.
         :data:`None` will use the default timeout configured on the server.
     :type timeout: float | None