Updates and fixes for a pretty major Stack Overflow/recursion loop issue, basic performance enhancements and a cleanup of some of the adapter logic.

Author: jhannahLCD

guidance/MigrateWebFormCommand.md

@@ -1,9 +1,25 @@
 # MigrateWebForm Project Document Command File
 
 ## Overview
+This file, logically, is a CodeFactory [Document Command](http://docs.codefactory.software/guidance/overview-commands-intro.html) and contains all of the logic neccesary for the CodeFactory runtime to call and execute from Visual Studio.  There is a single class defined called `public class MigrateWebForm : ProjectDocumentCommandBase`
 
 ## Fields
+The following fields are defined within this class:
+
+Declaration | Notes
+----------- | -----------
+`private static readonly string commandTitle` | Used to set the title that shows up in the context-menu for the Visual Studio Solution Explorer.
+`private static readonly string commandDescription` | Sets a longer descriptive text for the command that shows up in several of the loaded-command windows and diagnostics screens.
 
 ## Constrcutor
+There is a single default constructor that is defined.  This constructor should have no logic in it and is responsible for passing back its parameters to its baseclass.
+
+`public MigrateWebForm(ILogger logger, IVsActions vsActions) : base(logger, vsActions, commandTitle, commandDescription)`
+
+## Methods
+These are the following methods which are defined within this class file:
 
-## Methods
+Declaration | Notes
+--------- | --------
+`public override async Task<bool> EnableCommandAsync(VsProject result)` | Validation logic that will determine if this command should be enabled for execution.
+`public override async Task ExecuteCommandAsync(VsProject result)` | Code factory framework calls this method when the command has been executed. <br/> This method creates an instance of the [MigrateWebFormDialog](MigrateWebFormDialogFile.md) and displays it to the user.  All migration logic is actually initialized and called from the user control.

guidance/MigrateWebFormDialogFile.md

@@ -1,6 +1,8 @@
 # MigrateWebForm.xaml/.xaml.xs Files
 
 ## Overview
+This is a wpf/xaml custom user control definition that is used to display both migration status and gather input from the developer user.
+
 
 ## Fields
 

guidance/SetupBlazorProjectCommand.md

@@ -1,9 +1,25 @@
 # SetupBlazorProject.cs Project Command file
 
 ## Overview
+This file, logically, is a CodeFactory [Project Command](http://docs.codefactory.software/guidance/overview-commands-intro.html) and contains all of the logic neccesary for the CodeFactory runtime to call and execute from Visual Studio.  There is a single class defined called `public class MigrateWebForm : ProjectDocumentCommandBase`
 
 ## Fields
+The following fields are defined within this class:
+
+Declaration | Notes
+----------- | -----------
+`private static readonly string commandTitle` | Used to set the title that shows up in the context-menu for the Visual Studio Solution Explorer.
+`private static readonly string commandDescription` | Sets a longer descriptive text for the command that shows up in several of the loaded-command windows and diagnostics screens.
 
 ## Constrcutor
+There is a single default constructor that is defined.  This constructor should have no logic in it and is responsible for passing back its parameters to its baseclass.
+
+`public SetupBlazorProject(ILogger logger, IVsActions vsActions) : base(logger, vsActions, commandTitle, commandDescription)`
+
+## Methods
+These are the following methods which are defined within this class file:
 
-## Methods
+Declaration | Notes
+--------- | --------
+`public override async Task<bool> EnableCommandAsync(VsProject result)` | Validation logic that will determine if this command should be enabled for execution.
+`public override async Task ExecuteCommandAsync(VsProject result)` | Code factory framework calls this method when the command has been executed.

src/WebFormsToBlazorServerCommands/Commands/Document/MigrateWebForm.cs

@@ -18,7 +18,7 @@ namespace WebFormsToBlazorServerCommands.Commands.Document
     public class MigrateWebForm : ProjectDocumentCommandBase
     {
         private static readonly string commandTitle = "Migrate to Blazor";
-        private static readonly string commandDescription = "Replace with description of what this command does";
+        private static readonly string commandDescription = "Migrates a single *.aspx page to a Blazor componenet.";
 
 #pragma warning disable CS1998
 
@@ -62,7 +62,7 @@ public override async Task ExecuteCommandAsync(VsDocument result)
         {
             try
             {
-                //User Control to see the AngleSharp Nodes
+                //User Control
                 var migrateDialog = await VisualStudioActions.UserInterfaceActions.CreateVsUserControlAsync<MigrateWebFormDialog>();
 
                 //Get Project List