diff --git a/README.rst b/README.rst
index 2512de601828d81f4089bf4f98911a54ca9a1843..8b6f3d165546797fced63ad43dabc1f08351ef1f 100644
--- a/README.rst
+++ b/README.rst
@@ -98,6 +98,19 @@ HTTPS
 To use https, specify the host as a tuple in the form of ``('https', hostname)``.
 
 
+User-agents
+-----------
+Bots that run on Wikimedia wikis `require an informative user-agent for all
+API requests <https://meta.wikimedia.org/wiki/User-Agent_policy>`. To change
+the user-agent, you will need to include an appropriate parameter for 
+``clients_useragent`` when you initialize your ``Site``, as shown in the
+following example:
+
+.. code-block:: python
+    useragent = 'YourBot, based on mwclient v0.6.5. Run by User:You, you@gmail.com'
+    site = mwclient.Site(('https', 'en.wikipedia.org'), clients_useragent=useragent)
+
+
 Example
 -------