diff --git a/docs/source/address.rst b/docs/source/address.rst
index ce67339..33cb1c8 100644
--- a/docs/source/address.rst
+++ b/docs/source/address.rst
@@ -73,7 +73,8 @@ Payment IDs and integrated addresses
 Each Monero transaction may carry a **payment ID**. It is a 64 or 256-bit long
 number that carries additional information between parties. For example, a
 merchant can generate a payment ID for each order, or an exchange can assign
-one to each user, so they would know what is the purpose of incoming payment.
+one to each user. The customer/user would then attach the ID to the transaction,
+so the site operator would know what is the purpose of incoming payment.
 
 A short, 64-bit payment ID can be integrated into an address, creating, well...
 an **integrated address**.
diff --git a/docs/source/wallet.rst b/docs/source/wallet.rst
index 08ce6e6..c01d9b7 100644
--- a/docs/source/wallet.rst
+++ b/docs/source/wallet.rst
@@ -58,7 +58,7 @@ Every wallet can have separate accounts and each account can have numerous
 addresses. The ``Wallet.new_account()`` and ``Account.new_address()`` will
 create new instances.
 
-(This snippet, will fail on Monero v0.11.x)
+(This snippet will fail on Monero v0.11.x)
 
 .. code-block:: python