Minor updates

Add proper link to README.md
Updated a couple of typos in comments.
Remove suggestion to use private property in example.py

Author: tnydwrds

README.md

@@ -1,4 +1,4 @@
 #OX3-Python-API-Client - Python class to access OpenX Enterprise API
-OX3-Python-API-Client is a small class to help demonstrate how to connect to the OpenX Enterprise API. It depends on the [simplegeo/python-oauth2] module.
+OX3-Python-API-Client is a small class to help demonstrate how to connect to the OpenX Enterprise API. It depends on the [simplegeo/python-oauth2](https://github.com/simplegeo/python-oauth2) module.
 
 It currently supports Python 2.7 and will be updated to support Python 3.x.

example.py

@@ -29,18 +29,11 @@
 #
 #   token_str = ox.fetch_access_token()
 #   access_token = urlparse.parse_qs(token_str)['oauth_token'][0]
-#
-#
-# Alternatively, after calling fetch_access_token you can grab it off the
-# "private" _token property like:
-#
-#   access_token = ox._token.key
-#
 # 
 ox.validate_session()
 
 # Or manually validate your access token (but you will be resonpsible for
-# passing the requisite openx3_access_token for all successive API requests.
+# passing the requisite openx3_access_token for all successive API requests).
 #   token_str = ox.fetch_access_token()
 #   access_token = urlparse.parse_qs(token_str)['oauth_token'][0]
 #   cookie_header = {'Cookie': 'openx3_access_token=' + access_token}

ox3apiclient.py

@@ -86,7 +86,7 @@ def _sign_request(self, req):
             self._consumer,
             self._token)
 
-        # Update or original requests headers to include the OAuth Authorization
+        # Update our original requests headers to include the OAuth Authorization
         # header and return it.
         req.headers.update(oauth_req.to_header(realm=self.realm))
         return \
@@ -120,7 +120,7 @@ def request(self, url, method='GET', headers={}, data=None, sign=False):
     def fetch_request_token(self):
         """Helper method to fetch and set request token.
         
-        Returns oauth2.Token object.
+        Returns token string.
         """
         res = self.request(url=self.request_token_url, method='POST', sign=True)
         self._token = oauth.Token.from_string(res.read())
@@ -145,7 +145,7 @@ def authorize_token(self, email, password):
     def fetch_access_token(self):
         """Helper method to fetch and set access token.
         
-        Returns oauth2.Token object.
+        Returns token string.
         """
         res = self.request(url=self.access_token_url, method='POST', sign=True)
         self._token = oauth.Token.from_string(res.read())