Uppercase admonitions in docs

With the furo theme it's pretty clear that they are at the start of a
sentence.

diff --git a/docs/connection.rst b/docs/connection.rst
index bc40a4b788f6818a94a65028409bfc29cbb3f465..962b1fe3d130b419490772d8dcc09df5d78370e9 100644 (file)
--- a/docs/connection.rst
+++ b/docs/connection.rst
@@ -50,7 +50,7 @@ The `!Connection` class
 
     .. automethod:: close
 
-        .. note:: you can use :ref:`with connect(): ...<with-statement>` to
+        .. note:: You can use :ref:`with connect(): ...<with-statement>` to
             close the connection automatically when the block is exited.
 
     .. autoattribute:: closed
@@ -58,7 +58,7 @@ The `!Connection` class
 
     .. automethod:: cursor
 
-        .. note:: you can use :ref:`with conn.cursor(): ...<with-statement>`
+        .. note:: You can use :ref:`with conn.cursor(): ...<with-statement>`
             to close the cursor automatically when the block is exited.
 
 
@@ -70,7 +70,7 @@ The `!Connection` class
     .. automethod:: rollback()
     .. automethod:: transaction(savepoint_name: Optional[str] = None, force_rollback: bool = False) -> Transaction
 
-        .. note:: it must be called as ``with conn.transaction() as tx: ...``
+        .. note:: It must be called as ``with conn.transaction() as tx: ...``
 
         Inside a transaction block it will not be possible to call `commit()`
         or `rollback()`.
@@ -132,13 +132,13 @@ The `!AsyncConnection` class
     .. automethod:: connect
     .. automethod:: close
 
-        .. note:: you can use ``async with`` to close the connection
+        .. note:: You can use ``async with`` to close the connection
             automatically when the block is exited, but be careful about
             the async quirkness: see :ref:`with-statement` for details.
 
     .. automethod:: cursor
 
-        .. note:: you can use ``async with`` to close the cursor
+        .. note:: You can use ``async with`` to close the cursor
             automatically when the block is exited, but be careful about
             the async quirkness: see :ref:`with-statement` for details.
 
@@ -147,7 +147,7 @@ The `!AsyncConnection` class
 
     .. automethod:: transaction(savepoint_name: Optional[str] = None, force_rollback: bool = False) -> AsyncTransaction
 
-        .. note:: it must be called as ``async with conn.transaction() as tx: ...``.
+        .. note:: It must be called as ``async with conn.transaction() as tx: ...``.
 
     .. automethod:: notifies
     .. automethod:: set_client_encoding

diff --git a/docs/usage.rst b/docs/usage.rst
index 896d1f6577a413d200abeae518271c418af9a125..85f3433a9e0b984110b7a4fa000f7a6a6f326938 100644 (file)
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -431,7 +431,7 @@ transaction, such as :sql:`CREATE DATABASE`, :sql:`VACUUM`, :sql:`CALL` on
 
 .. warning::
 
-    by default even a simple :sql:`SELECT` will start a transaction: in
+    By default even a simple :sql:`SELECT` will start a transaction: in
     long-running programs, if no further action is taken, the session will
     remain *idle in transaction*, an undesirable condition for several
     reasons (locks are held by the session, tables bloat...). For long lived