Cleaned up README

Author: Josh Brandoff

README.md

@@ -1,27 +1,36 @@
-yoloAPI
-===================================================================
-An flask-oauthlib server example for 'Resource Owner Password Credentials Grant'
+# Yolo API
+
+This is a Flask-OAuthlib server example for the 'Resource Owner Password Credentials Grant' described in [RFC 6749 (Section 1.3.3)](http://tools.ietf.org/html/rfc6749#section-1.3.3).
+
+## Deployment
+
+Clone this repository and install all dependencies:
 
-##### Get it up and running
-To get it up and running clone this repository and install the dependencies.
 ```bash
-pip install -r requirements.txt
+$ pip install -r requirements.txt
 ```
-After this you can run the application with `python app.py`.
 
-##### Management
-At this point you should to go `http://localhost:5000` and generate a client and also create a user.
-Now you can use `curl` for testing the application and the access the protected resource.
+Once all dependencies are installed, you may run the application with `python app.py`.
+
+## User and Client Management
+
+For the example to work properly, you will need to create a client and user. You can create users and clients through the management interface available at [http://localhost:5000](http://localhost:5000).
 
-##### Get a Bearer token
+## Testing
+
+After creating a user and client, you may use curl to test the application.
+
+### Generating a Bearer Token
 
 ```bash
 curl -X POST -d "client_id=9qFbZD4udTzFVYo0u5UzkZX9iuzbdcJDRAquTfRk&grant_type=password&username=jonas&password=pass" http://localhost:5000/oauth/token
 {"access_token": "NYODXSR8KalTPnWUib47t5E8Pi8mo4", "token_type": "Bearer", "refresh_token": "s6L6OPL2bnKSRSbgQM3g0wbFkJB4ML", "scope": ""}
 ```
 
-##### Use the Bearer token to access the protected resource
+### Accessing a Protected Resource Using Retrieved Bearer Token
+
 ```bash
 curl -H "Authorization: Bearer NYODXSR8KalTPnWUib47t5E8Pi8mo4" http://localhost:5000/yolo
-YOLO!!! You made it through and accessed the protected resource
+YOLO! Congraulations, you made it through and accessed the protected resource!
 ```
+