diff --git a/README.md b/README.md index 9d92b25ae..512a14846 100644 --- a/README.md +++ b/README.md @@ -188,15 +188,13 @@ Invoke-OpenConsoleBuild bcz ``` -## Debugging Terminal +## Running & Debugging -To debug Terminal in VS, right click on `CascadiaPackage` (in the Solution Explorer) and go to properties. In the Debug menu, change "Application process" and "Background task process" to "Native Only". +To debug the Windows Terminal in VS, right click on `CascadiaPackage` (in the Solution Explorer) and go to properties. In the Debug menu, change "Application process" and "Background task process" to "Native Only". You should then be able to build & debug the Terminal project by hitting F5. -### Debugging - -* To debug in VS, right click on CascadiaPackage (from VS Solution Explorer) and go to properties, in the Debug menu, change "Application process" and "Background task process" to "Native Only". +> 👉 You will _not_ be able to launch the Terminal directly by running the WindowsTerminal.exe. For more details on why, see [#926](https://github.com/microsoft/terminal/issues/926), [#4043](https://github.com/microsoft/terminal/issues/4043) ### Coding Guidance