From 2633ee2b71ea133a5be746841027fe6b247c33ce Mon Sep 17 00:00:00 2001
From: Bjarke Sporring <work.bjarke@gmail.com>
Date: Wed, 14 Jan 2026 17:29:22 +0100
Subject: [PATCH] Add clear terminal opening guidance for VSCode

- Enhance instructions for opening integrated terminal in VSCode
- Provide multiple methods: Ctrl+backtick, menu, and Command Palette
- Add visual separation with headers for important information
- Emphasize that terminal opening is REQUIRED for next steps
- Include detailed fallback instructions if VSCode command fails
- Make terminal guidance impossible to miss with multiple clear options
- Remove ambiguity about how to access terminal in VSCode
---
 install.ps1 | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/install.ps1 b/install.ps1
index fc9254e..57ee7c2 100644
--- a/install.ps1
+++ b/install.ps1
@@ -619,14 +619,35 @@ Write-Host "  code --version" -ForegroundColor White
                 Write-Success "Repository cloned successfully!"
             }
             
-            # Open in VSCode
+# Open in VSCode
             Write-Host "  Opening in VSCode..." -ForegroundColor Cyan
             if (Get-Command code -ErrorAction SilentlyContinue) {
                 & code $workshopPath
                 Write-Success "VSCode opened with the workshop repository"
+                Write-Host ""
+                Write-Host "=== IMPORTANT: Terminal Instructions ===" -ForegroundColor Yellow
+                Write-Host "Once VSCode opens, you MUST open the integrated terminal:" -ForegroundColor White
+                Write-Host ""
+                Write-Host "Option 1 (Recommended): Press Ctrl+` (backtick key)" -ForegroundColor Cyan
+                Write-Host "Option 2: Use menu: View → Terminal" -ForegroundColor Cyan
+                Write-Host "Option 3: Use Command Palette: Ctrl+Shift+P → 'Terminal: Create New Terminal'" -ForegroundColor Cyan
+                Write-Host ""
+                Write-Host "=== Quick Start (run in VSCode terminal) ===" -ForegroundColor Yellow
+                Write-Host "  cd 01-essentials\01-basics" -ForegroundColor White
+                Write-Host "  .\setup.ps1" -ForegroundColor White
+                Write-Host ""
+                Write-Host "The terminal should show 'PowerShell' and open to the correct directory." -ForegroundColor Green
+                Write-Host ""
             } else {
                 Write-Warning "VSCode command not found. Please open manually:"
                 Write-Host "  code '$workshopPath'" -ForegroundColor White
+                Write-Host ""
+                Write-Host "=== Manual Instructions ===" -ForegroundColor Yellow
+                Write-Host "1. Open VSCode manually" -ForegroundColor White
+                Write-Host "2. Open integrated terminal (Ctrl+` or View → Terminal)" -ForegroundColor White
+                Write-Host "3. Navigate: cd 01-essentials\01-basics" -ForegroundColor White
+                Write-Host "4. Run: .\setup.ps1" -ForegroundColor White
+                Write-Host ""
             }
             
             Write-Host ""