Fix description of debugger console setting (#6726)

This PR updates the description of the `console` debugger setting. Improvements made:
* The launch.json setting is applicable to all project types, so don't indicate it only applies to console projects
* Update wording to match what we have in the documentation
* Add a link to the documentation
* Don't incorrectly indicate that `internalConsole` doesn't support reading from the console.

This PR also increases the max VSIX size to get PR builds working again. A node upgrade (18.18.2 -> 18.19.0) seems to have pushed us over the limit.

Author: gregg-miskelly

package.nls.json

@@ -188,16 +188,16 @@
       "Markdown text between `` should not be translated or localized (they represent literal text) and the capitalization, spacing, and punctuation (including the ``) should not be altered."
     ]
   },
-  "generateOptionsSchema.console.markdownDescription": "When launching console projects, indicates which console the target program should be launched into.",
+  "generateOptionsSchema.console.markdownDescription": "Indicates which console the target program should be launched into. See https://aka.ms/VSCode-CS-LaunchJson-Console for more information.",
   "generateOptionsSchema.console.settingsDescription": {
-    "message": "**Note:** _This option is only used for the `dotnet` debug configuration type_.\n\nWhen launching console projects, indicates which console the target program should be launched into.",
+    "message": "**Note:** _This option is only used for console projects launched with the `dotnet` debug configuration type_.\n\nIndicates which console the target program should be launched into. See https://aka.ms/VSCode-CS-LaunchJson-Console for more information.",
     "comment": [
       "Markdown text between `` should not be translated or localized (they represent literal text) and the capitalization, spacing, and punctuation (including the ``) should not be altered."
     ]
   },
-  "generateOptionsSchema.console.internalConsole.enumDescription": "Output to the VS Code Debug Console. This doesn't support reading console input (ex:Console.ReadLine).",
-  "generateOptionsSchema.console.integratedTerminal.enumDescription": "VS Code's integrated terminal.",
-  "generateOptionsSchema.console.externalTerminal.enumDescription": "External terminal that can be configured via user settings.",
+  "generateOptionsSchema.console.internalConsole.enumDescription": "The target process's console input (stdin) and output (stdout/stderr) are routed through the VS Code Debug Console.",
+  "generateOptionsSchema.console.integratedTerminal.enumDescription": "The target process will run inside VS Code's integrated terminal.",
+  "generateOptionsSchema.console.externalTerminal.enumDescription": "The target process will run inside its own external terminal. When using this mode, you will need to switch focus between Visual Studio Code and the external terminal window.",
   "generateOptionsSchema.externalConsole.markdownDescription": {
     "message": "Attribute `externalConsole` is deprecated, use `console` instead. This option defaults to `false`.",
     "comment": [

src/tools/OptionsSchema.json

@@ -371,12 +371,12 @@
           "type": "string",
           "enum": [ "internalConsole", "integratedTerminal", "externalTerminal" ],
           "enumDescriptions": [
-            "Output to the VS Code Debug Console. This doesn't support reading console input (ex:Console.ReadLine).",
-            "VS Code's integrated terminal.",
-            "External terminal that can be configured via user settings."
+            "The target process's console input (stdin) and output (stdout/stderr) are routed through the VS Code Debug Console.",
+            "The target process will run inside VS Code's integrated terminal.",
+            "The target process will run inside its own external terminal. When using this mode, you will need to switch focus between Visual Studio Code and the external terminal window."
           ],
-          "markdownDescription": "When launching console projects, indicates which console the target program should be launched into.",
-          "settingsDescription": "**Note:** _This option is only used for the `dotnet` debug configuration type_.\n\nWhen launching console projects, indicates which console the target program should be launched into.",
+          "markdownDescription": "Indicates which console the target program should be launched into. See https://aka.ms/VSCode-CS-LaunchJson-Console for more information.",
+          "settingsDescription": "**Note:** _This option is only used for console projects launched with the `dotnet` debug configuration type_.\n\nIndicates which console the target program should be launched into. See https://aka.ms/VSCode-CS-LaunchJson-Console for more information.",
           "default": "internalConsole"
         },
         "externalConsole": {

test/artifactTests/vsix.test.ts

@@ -18,7 +18,7 @@ describe('Vscode VSIX', () => {
     vsixFiles.forEach((element) => {
         // We're packaging the platform specific Roslyn server with ready to run in the vsix, so the size should be roughly ~50MB
         // We also publish the Razor server, which is roughly ~75MB
-        const sizeInMB = 220;
+        const sizeInMB = 230;
         const maximumVsixSizeInBytes = sizeInMB * 1024 * 1024;
 
         describe(`Given ${element}`, () => {