adding new sample readmes

Author: peakyy

Client_OM_Sample/ClientOmConsoleApp/ClientOmConsoleApp/App.config renamed to Client_Libraries_Sample/ClientLibrariesConsoleApp/App.config

@@ -3,7 +3,7 @@ Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 15
 VisualStudioVersion = 15.0.26228.9
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ClientOmConsoleApp", "ConsoleApp1\ClientOmConsoleApp.csproj", "{F7AC99CF-0972-4727-AC95-F537EF4EB4EA}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ClientLibrariesConsoleApp", "ClientLibrariesConsoleApp.csproj", "{F7AC99CF-0972-4727-AC95-F537EF4EB4EA}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

Client_OM_Sample/ClientOmConsoleApp/ClientOmConsoleApp/ClientOmConsoleApp.csproj renamed to Client_Libraries_Sample/ClientLibrariesConsoleApp/ClientLibrariesConsoleApp.csproj

@@ -9,9 +9,9 @@
 using Microsoft.VisualStudio.Services.Common;
 using Microsoft.VisualStudio.Services.WebApi;
 
-namespace ClienOmConsoleApp
+namespace ClienLibrariesConsoleApp
 {
-    class ClientOmConsoleApp
+    class ClientLibrariesConsoleApp
     {
         //Console application to execute a user defined work item query
         static void Main(string[] args)

Client_OM_Sample/ClientOmConsoleApp/ClientOmConsoleApp.sln renamed to Client_Libraries_Sample/ClientLibrariesConsoleApp/ClientLibrariesConsoleApp.sln

@@ -0,0 +1,24 @@
+# Client Libraries Sample
+
+The [Client Libraries](https://www.visualstudio.com/en-us/docs/integrate/get-started/client-libraries/dotnet) are .NET libraries made to simplify integration with Visual Studio Team Services and Team Foundation Server (2015 and later). They allow access to both the Traditional Client Object Model and [new REST APIs](https://www.visualstudio.com/en-us/docs/integrate/api/overview).
+
+## Sample Application
+
+ This buildable sample will walk you through the steps to create an application which uses the [Client Libraries](https://www.visualstudio.com/en-us/docs/integrate/get-started/client-libraries/dotnet) to open an interactive login prompt and use that authentication state to execute a user pre-defined query written in [Work Item Query Language](https://msdn.microsoft.com/en-us/library/bb130198(v=vs.90).aspx). Query results are output into the console.
+
+ ## Step 1: Clone or download vsts-auth-samples repository
+
+From a shell or command line: 
+```no-highlight
+git clone https://github.com/Microsoft/vsts-auth-samples.git
+```
+
+## Step 2: Run the sample
+
+1. Navigate to the sample in cloned repo `vsts-auth-samples/Client_Libraries_Sample/ClientLibrariesConsoleApp/`
+2. Use [Nuget package restore](https://docs.microsoft.com/en-us/nuget/consume-packages/package-restore) to ensure you have all dependencies installed
+3. Open the solution file `ClientLibrariesConsoleApp.sln` in [Visual Studio IDE 2017](https://www.visualstudio.com/downloads/)
+4. Open CS file `Program.cs` and there will be 2 input fields:
+    * `collectionUri` - Mutable value. This is the url to your VSTS/TFS account.
+    * `query` - Mutable value. This is the WIQL query you want to execute. Replace this with any query you want to execute.
+5. Build and run solution. After running you should see a list of the IDs all work items which match your query restrictions.

Client_OM_Sample/ClientOmConsoleApp/ClientOmConsoleApp/Program.cs renamed to Client_Libraries_Sample/ClientLibrariesConsoleApp/Program.cs

@@ -10,4 +10,20 @@ This buildable sample will walk you through the steps to create a client-side co
 
 From a shell or command line: 
 ```no-highlight
-git clone https://github.com/Microsoft/vsts-auth-samples.git
+git clone https://github.com/Microsoft/vsts-auth-samples.git
+```
+
+## Step 2: Install and configure ADAL (optional)
+
+Package: `Microsoft.Identity.Model.Clients.ActiveDirectory` has already been installed and configured in the sample, but if you are adding to your own project you will need to [install and configure it yourself](https://www.nuget.org/packages/Microsoft.IdentityModel.Clients.ActiveDirectory). 
+
+## Step 3: Run the sample
+
+1. Navigate to the sample in cloned repo `vsts-auth-samples/Device_Profile_Sample/Device_Profile_Get_Identity_Data/`
+2. Use [Nuget package restore](https://docs.microsoft.com/en-us/nuget/consume-packages/package-restore) to ensure you have all dependencies installed
+3. Open the solution file `Device Profile - Get Identity Data.sln` in [Visual Studio IDE 2017](https://www.visualstudio.com/downloads/)
+4. Open CS file `Program.cs` and there are 2 important fields to be aware of:
+    * `VSTSResourceId` - Immutable value. Denotes that we need a VSTS access token.
+    * `clientId` - Immutable value*. *Normally your app's registered AAD clientId, but for VSTS is must be the VS client ID provided
+    These fields are how we configure ADAL to aquire a VSTS access token for the authenticated user.
+5. Build and run solution. You should see a console window waiting for text input. Input `userdata` to start the Device Profile auth flow. After authenticating you should see VSTS identity information displayed in the console window.

Client_OM_Sample/ClientOmConsoleApp/ClientOmConsoleApp/Properties/AssemblyInfo.cs renamed to Client_Libraries_Sample/ClientLibrariesConsoleApp/Properties/AssemblyInfo.cs

@@ -19,14 +19,14 @@ Package: `Microsoft.Identity.Model.Clients.ActiveDirectory` has already been ins
 
 ## Step 3: Run the sample
 
-1. Navigate to the ADAL C# sample in cloned repo `vsts-auth-samples/Managed_Client_Sample_(ADAL_C#)/`
+1. Navigate to the ADAL C# sample in cloned repo `vsts-auth-samples/Managed_Client_ADAL_Sample/`
 2. Use [Nuget package restore](https://docs.microsoft.com/en-us/nuget/consume-packages/package-restore) to ensure you have all dependencies installed
-2. Open the solution file `SimpleAdalConsoleApp.sln` in [Visual Studio IDE](https://www.visualstudio.com/downloads/)
-3. Open CS file `Program.cs` and there will be 3 input fields:
+3. Open the solution file `SimpleAdalConsoleApp.sln` in [Visual Studio IDE 2017](https://www.visualstudio.com/downloads/)
+4. Open CS file `Program.cs` and there will be 3 input fields:
     * `VSTSResourceId` - Immutable value. Denotes that we need a VSTS access token.
     * `clientId` - Immutable value*. *Normally your app's registered AAD clientId, but for VSTS is must be the VS client ID provided
     * `VSTSAccountName` - Mutable value. Update with the name of the VSTS account you would like to access. (e.g. "myaccount" from myaccount.visualstuido.com)
-4. Build and run solution. After running you should see a list of all projects inside of myaccount.
+5. Build and run solution. After running you should see a list of all projects inside of myaccount.