diff --git a/README.rst b/README.rst
index c37b05d..464b8e6 100644
--- a/README.rst
+++ b/README.rst
@@ -8,15 +8,15 @@ v2.0 API. This project is hosted on `Github
 Installation
 ============
 
-This library is released to PyPI, so the easiest way to install it is to use
-easy_install::
-
-    easy_install wolframalpha
-
-or pip::
+This library is released to PyPI - the Python Package Index, so the easiest way to install it is to use
+pip::
 
     pip install wolframalpha
 
+or easy_install::
+
+    easy_install wolframalpha
+
 If you don't have these tools or you prefer not to use setuptools, you may
 also simply extract the 'wolframalpha' directory an appropriate location in
 your Python path.
@@ -34,13 +34,19 @@ Then, you can send queries, which return Result objects::
 
     res = client.query('temperature in Washington, DC on October 3, 2012')
 
-Result objects have `pods` attribute (a Pod is an answer from Wolfram Alpha)::
+Result objects have `pods` (a Pod is an answer group from Wolfram Alpha)::
 
     for pod in res.pods:
         do_something_with(pod)
 
-You may also query for simply the pods which have 'Result' titles::
+Pod objects have `subpods` (a Subpod is a specific response with the plaintext reply and some additional info)::
+    
+    for pod in res.pods:
+        for sub in pod:
+            print(sub.text)
 
-    print(next(res.results).text)
+You may also query for simply the pods which have 'Result' titles or are marked as 'primary'::
+
+    print(res.results[0])
 
 For more information, read the source.