Add missing API documentation

Author: daviwil

src/PowerShellEditorServices.Host/Program.cs

@@ -16,6 +16,7 @@ class Program
         [STAThread]
         static void Main(string[] args)
         {
+#if DEBUG
             // In the future, a more robust argument parser will be added here
             bool waitForDebugger =
                 args.Any(
@@ -36,6 +37,7 @@ static void Main(string[] args)
                     waitCountdown--;
                 }
             }
+#endif
 
             // TODO: Select host, console host, and transport based on command line arguments
 

src/PowerShellEditorServices/Language/LanguageService.cs

@@ -207,11 +207,13 @@ public FindReferencesResult FindReferencesOfSymbol(
         }
 
         /// <summary>
-        /// Finds the definition of a symbol in the script 
+        /// Finds the definition of a symbol in the script file or any of the
+        /// files that it references.
         /// </summary>
-        /// <param name="foundSymbol">The symbol to find a definition for</param>
-        /// <param name="referencedFiles">An array of scriptFiles too search for the definition in</param>
-        /// <returns>GetDefinitionResult</returns>
+        /// <param name="sourceFile">The initial script file to be searched for the symbol's definition.</param>
+        /// <param name="foundSymbol">The symbol for which a definition will be found.</param>
+        /// <param name="workspace">The Workspace to which the ScriptFile belongs.</param>
+        /// <returns>The resulting GetDefinitionResult for the symbol's definition.</returns>
         public GetDefinitionResult GetDefinitionOfSymbol(
             ScriptFile sourceFile,
             SymbolReference foundSymbol,

src/PowerShellEditorServices/Session/Workspace.cs

@@ -11,6 +11,10 @@
 
 namespace Microsoft.PowerShell.EditorServices.Session
 {
+    /// <summary>
+    /// Manages a "workspace" of script files that are open for a particular
+    /// editing session.  Also helps to navigate references between ScriptFiles.
+    /// </summary>
     public class Workspace
     {
         #region Private Fields