Added a readme and removed an empty comment.

Author: mitchdenny

NonInteractivePatGenerationSample/NonInteractivePatGenerationSample.sln

@@ -5,6 +5,11 @@ VisualStudioVersion = 15.0.27004.2005
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "NonInteractivePatGenerationSample", "NonInteractivePatGenerationSample\NonInteractivePatGenerationSample.csproj", "{2A8F9A96-2FB4-4FCA-A67C-44C757D354E3}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{EF421301-2EA7-486F-A4FD-275164554E00}"
+	ProjectSection(SolutionItems) = preProject
+		README.md = README.md
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

NonInteractivePatGenerationSample/NonInteractivePatGenerationSample/Program.cs

@@ -17,12 +17,13 @@ public class Program
         private const string VstsResourceId = "499b84ac-1321-427f-aa17-267ca6975798";
 
         // This is the resource for your own application registered in AAD (which needs access to the VSTS application).
+        // 
         private const string ClientId = "[your AAD application client ID]";
 
         public static void Main(string[] args)
         {
             var adalCredential = new UserPasswordCredential(
-                "[your AAD username]", // 
+                "[your AAD username]",
                 "[your AAD password]"
                 );
 

NonInteractivePatGenerationSample/README.md

@@ -0,0 +1,23 @@
+# Non-interactive PAT generation Sample
+
+This sample shows how to generate a Personal Access Token (PAT) using the [Client Libraries](https://www.visualstudio.com/en-us/docs/integrate/get-started/client-libraries/dotnet). You cannot use a PAT to generate a PAT and so this sample makes use of the Azure Active Directory Authentication Library (ADAL) to acquire an AAD token which is then used as a credential to authenticate requests to VSTS. This sample also uses the UserPasswordCredential rather than relying on the interactive pop-up dialog - this can be useful in scenarios where you need to generate a PAT associated with an account that does not have interactive login rights.
+
+## Sample Application
+
+This sample shows the basic flow for calling ADAL, and then using the resulting token as credentials to call the ```CreateSessionToken``` method on the ```DelegatedAuthorizationHttpClient``` class. In order to run this application you will need to [register your own AAD application](https://docs.microsoft.com/en-us/azure/active-directory/develop/active-directory-integrating-applications).
+
+ ## 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/NonInteractivePatGenerationSample/`
+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 `NonInteractivePatGenerationSample.sln` in [Visual Studio 2017](https://www.visualstudio.com/downloads/)
+4. Open CS file `Program.cs` and look for the ```[value]``` placeholders.
+5. Replace them with the appropriate values.
+6. Build and run the solution, the generate PAT will be output to the console window.