Clarify the handlers

Author: JustinGrote

src/features/DebugSession.ts

@@ -151,10 +151,12 @@ export class DebugSessionFeature extends LanguageClientConsumer
             }
 
 
-            // The dispose shorthand demonry for making an event one-time courtesy of: https://github.com/OmniSharp/omnisharp-vscode/blob/b8b07bb12557b4400198895f82a94895cb90c461/test/integrationTests/launchConfiguration.integration.test.ts#L41-L45
 
+            // Ensure the .NET session stops before the PowerShell session so that the .NET debug session doesnt emit an error about the process unexpectedly terminating
             const startDebugEvent = vscode.debug.onDidStartDebugSession((dotnetAttachSession) => {
                 // Makes the event one-time
+                // HACK: This seems like you would be calling a method on a variable not assigned yet, but it does work in the flow.
+                // The dispose shorthand demonry for making an event one-time courtesy of: https://github.com/OmniSharp/omnisharp-vscode/blob/b8b07bb12557b4400198895f82a94895cb90c461/test/integrationTests/launchConfiguration.integration.test.ts#L41-L45
                 startDebugEvent.dispose();
                 this.logger.write(`Debugger session detected: ${dotnetAttachSession.name} (${dotnetAttachSession.id})`);
                 if (dotnetAttachSession.configuration.name == dotnetDebuggerConfig.name) {