Cleanup text in the README

Author: Grace Yim

README.md

@@ -1,6 +1,8 @@
 #ToopherPython [![Build Status](https://travis-ci.org/toopher/toopher-python.png?branch=master)](https://travis-ci.org/toopher/toopher-python)
 
-ToopherPython is a Toopher API library that simplifies the task of interfacing with the Toopher API from Python code.  This project wrangles all the required OAuth and JSON functionality so you can focus on just using the API.
+ToopherPython is a Toopher API library that simplifies the task of interfacing with the Toopher API from Python code.
+  This project wrangles all the dependency libraries and handles the required OAuth and JSON functionality so you can
+  focus on just using the API.
 
 ### Python Version
 * 2.6
@@ -12,20 +14,23 @@ Make sure you visit [https://dev.toopher.com](https://dev.toopher.com) to get ac
 ## ToopherApi Workflow
 
 ### Step 1: Pair
-Before you can enhance your website's actions with Toopher, your customers will need to pair their mobile device's Toopher app with your website.  To do this, they generate a unique pairing phrase from within the app on their mobile device.  You will need to prompt them for a pairing phrase as part of the Toopher enrollment process.  Once you have a pairing phrase, just send it to the Toopher web service and we'll return a pairing ID that you can use whenever you want to authenticate an action for that user.
+Before you can enhance your website's actions with Toopher, your customers will need to pair their mobile device's Toopher app with your website.  To do this, they generate a unique pairing phrase from within the app on their mobile device.  You will need to prompt them for a pairing phrase as part of the Toopher enrollment process.  Once you have a pairing phrase, just send it to the Toopher web service along with your requester credentials and we'll return a pairing ID that you can use whenever you want to authenticate an action for that user.
 
 ```python
 import toopher
 
-# Create an API Object Using Your Credentials
+# Create an API object using your credentials
 api = toopher.ToopherApi("<your consumer key>", "<your consumer secret>")
 
 # Step 1 - Pair with their mobile device's Toopher app
 pairing = api.pair("username@yourservice.com", "pairing phrase")
 ```
 
 ### Step 2: Authenticate
-You have complete control over what actions you want to authenticate using Toopher (for example: logging in, changing account information, making a purchase, etc.).  Just send us the user's pairing ID and a name for the terminal they're using and we'll make sure they actually want it to happen.
+You have complete control over what actions you want to authenticate using Toopher (logging in, changing account
+information, making a purchase, etc.).  Just send us the username or pairing ID and we'll make sure they actually want it to happen
+. You can also choose to provide the following optional parameters: terminal name, requester specified ID and
+action name (*default: "Log in"*).
 
 ```python
 # Step 2 - Authenticate a log in
@@ -38,18 +43,19 @@ if not authentication_request.pending and authentication_request.granted:
 ```
 
 ## ToopherIframe Workflow
+
 ### Step 1: Embed a request in an IFRAME
 1. Generate an authentication URL by providing a username.
 2. Display a webpage to your user that embeds this URL within an `<iframe>` element.
 
 ```python
 import toopher
 
-# Create an API Object Using Your Credentials
+# Create an API object using your credentials
 iframe_api = toopher.ToopherIframe("<your consumer key>", "<your consumer secret>")
 
 
-auth_iframe_url = iframe_api.get_authentication_url(username);
+auth_iframe_url = iframe_api.get_authentication_url("username@yourservice.com");
 
 # Add an <iframe> element to your HTML:
 # <iframe id="toopher_iframe" src=auth_iframe_url />
@@ -63,7 +69,7 @@ The simplest way to validate the postback data is to call `is_authentication_gra
 # Retrieve the postback data as a string from POST parameter 'iframe_postback_data'
 postback_data = request.args['iframe_postback_data']
 
-# Returns boolean indicating if user should be granted access
+# Returns boolean indicating if authentication request was granted by user
 authentication_request_granted = iframe_api.is_authentication_granted(postback_data)
 
 if authentication_request_granted:
@@ -74,7 +80,8 @@ if authentication_request_granted:
 If any request runs into an error a `ToopherApiError` will be thrown with more details on what went wrong.
 
 ### Demo
-Check out `demo.py` for an example program that walks you through the whole process!  Just download the contents of this repo, make sure you have the dependencies listed above installed, and then run it like-a-this:
+Check out `demo.py` for an example program that walks you through the whole process!  Just download the contents of
+this repo, make sure you have the dependencies installed, and run the command below:
 ```shell
 $ python demo.py
 ```
@@ -89,10 +96,10 @@ $ pip install -r requirements.txt
 ```
 
 ### Tests
-To run tests using [nose](http://nose.readthedocs.org/en/latest/) enter:
+To run the tests using [nose](http://nose.readthedocs.org/en/latest/) enter:
 ```shell
 $ nosetests test
 ```
 
 ## License
-ToopherPython is licensed under the MIT License. See LICENSE.txt for the full license text.
+ToopherPython is licensed under the MIT License. See LICENSE.txt for the full text.