Update README.md

Author: willsmythe

README.md

@@ -1,13 +1,15 @@
-This sample .NET MVC web app shows how to use the OAuth 2.0 capabilities in Visual Studio Online to prompt users to authorize your app and to acquire an access token and refresh token to access their Visual Studio Online resources.
+# Visual Studio Team Services .NET OAuth Sample
 
-To learn more about OAuth in Visual Studio Online, see [Authorize access with OAuth 2.0](http://www.visualstudio.com/integrate/get-started/get-started-auth-oauth2-vsi)
+This sample .NET MVC web app shows how to use the OAuth 2.0 capabilities in Visual Studio Team Services to prompt users to authorize your app and to acquire an access token and refresh token to access their Visual Studio Team Services resources.
 
-###Pre-requisities###
+To learn more about OAuth in Visual Studio Team Services, see [Authorize access with OAuth 2.0](http://www.visualstudio.com/integrate/get-started/get-started-auth-oauth2-vsi)
 
-These instructions assume you will be deploying this sample app to an Azure web site. To learn more and to get started, visit [Get started with Azure Web Sites and ASP.NET](http://azure.microsoft.com/en-us/documentation/articles/web-sites-dotnet-get-started).
+## How to setup
 
-###Setup###
-1. Register an OAuth client app on Visual Studio Online (https://app.vssps.visualstudio.com/app/register) (note: the callback URL should be https://yoursite.azurewebsites.net/oauth/callback, where "yoursite" is the name of your Azure web site)
+> These instructions assume you will be deploying this sample app to an Azure web site. To learn more and to get started, visit [Get started with Azure Web Sites and ASP.NET](http://azure.microsoft.com/en-us/documentation/articles/web-sites-dotnet-get-started).
+
+1. Register an OAuth client app in Visual Studio Team Services (https://app.vssps.visualstudio.com/app/register) 
+   * The callback URL should be https://yoursite.azurewebsites.net/oauth/callback, where "yoursite" is the name of your Azure web site
 2. Clone this repository
 3. Open the solution (VSOClientOAuthSample.sln) in Visual Studio 2013 (or later)
 4. Update the following settings in web.config to match the values in the app you just registered:
@@ -16,20 +18,21 @@ These instructions assume you will be deploying this sample app to an Azure web
   *  Scope (space separated)
   *  Callback URL
 5. Build (this will trigger a NuGet package restore, which will pull in all dependencies of the project)
-6. Deploy the app.
+6. Deploy the app to Azure
+
+### Run the sample
 
-###Run###
-1. Navigate to the app (https://yoursite.azurewebsites.net)
-2. Confirm your App ID, scope, and callback URL are showing properly (lower left)
-3. Click the Start button
-4. Sign in to Visual Studio Online (if necessary)
+1. Navigate to the deployed app (https://yoursite.azurewebsites.net)
+2. Confirm your App ID, scope, and callback URL are displayed properly
+   ![app](appstart.png)
+3. Click **Start**
+4. Sign in to Visual Studio Team Services (if prompted)
 5. Review and accept the authorization request
 
-If everything is setup properly, Visual Studio Online will generate an access token and refresh token and both values will be displayed. **As an app developer, you would always keep these values secret**. Also a new authorization will appear on [your profile page](https://app.vssps.visualstudio.com/Profile/View).
+If everything is setup properly, Visual Studio Team Services will issue an access token and refresh token and both values will be displayed. **You should keep these values secret**. Also a new authorization will appear in [your profile page](https://app.vssps.visualstudio.com/Profile/View).
 
-With this access token, you can call [Visual Studio Online REST APIs](http://www.visualstudio.com/integrate/reference/reference-vso-overview-vsi) by passing the access token in the Authorization header. For example:
+With the access token you can invoke [Visual Studio Team Services REST APIs](http://www.visualstudio.com/integrate/reference/reference-vso-overview-vsi) by passing the access token in the Authorization header.FOr example:
 
 ```
-Authorization: Bearer {your access token}
+Authorization: Bearer {access token}
 ```
-