diff --git a/docs/howto/usingurllib2.rst b/docs/howto/usingurllib2.rst
index a31bcc9bb..139bf7173 100644
--- a/docs/howto/usingurllib2.rst
+++ b/docs/howto/usingurllib2.rst
@@ -4,25 +4,31 @@ Using urllib2
 Python's standard library comes with some nice modules
 you can use to test your api or even write a full client.
 
+Using the 'GET' method
+----------------------
+
 Here's an example which does a 'GET' on the `model-resource` example
 in the sandbox.::
 
     >>> import urllib2
     >>> r = urllib2.urlopen('htpp://rest.ep.io/model-resource-example')
-    # You can check if the response was ok:
-    >>> r.getcode()
+    >>> r.getcode() # Check if the response was ok
     200
-    # Or examin the response itself:
-    >>> print r.read()
+    >>> print r.read() # Examin the response itself
     [{"url": "http://rest.ep.io/model-resource-example/1/", "baz": "sdf", "foo": true, "bar": 123}]
 
-And here's an example which does a 'POST' to create a new instance::
+Using the 'POST' method
+-----------------------
+
+And here's an example which does a 'POST' to create a new instance. First let's encode 
+the data we want to POST. We'll use `urllib` for encoding and the `time` module 
+to send the current time as as a string value for our POST.::
 
-    # First encode tha data we want to POST, we'll use urllib for encoding
-    # and the time module to send the current time as as a string value for our POST
     >>> import urllib, time
     >>> d = urllib.urlencode((('bar', 123), ('baz', time.asctime())))
-    # Now use the Request class and specify the 'Content-type'
+   
+Now use the `Request` class and specify the 'Content-type'::
+
     >>> req = urllib2.Request('http://rest.ep.io/model-resource-example/', data=d, headers={'Content-Type':'application/x-www-form-urlencoded'})
     >>> resp = urllib2.urlopen(req)
     >>> resp.getcode()