docs: Add VSCode macOS Downloads folder troubleshooting and version requirements

doc/articles/common-issues-vscode.md

@@ -15,6 +15,43 @@ For assistance configuring or running Android or iOS emulators, see the [Android
 
 If you're not sure whether your environment is correctly configured for Uno Platform development, running the [`uno-check` command-line tool](external/uno.check/doc/using-uno-check.md) should be your first step.
 
+### macOS-specific issues
+
+#### VS Code in Downloads folder (read-only mode)
+
+If VS Code has been left in the Downloads folder on macOS, it can end up in read-only mode, which prevents proper extension functionality and updates.
+
+**Solution**: Move VS Code from the Downloads folder to the Applications folder:
+
+1. Quit VS Code if it's running
+1. Open Finder and navigate to the Downloads folder
+1. Locate Visual Studio Code
+1. Drag Visual Studio Code to the Applications folder (or use `Cmd+C` to copy, then `Cmd+V` to paste in Applications)
+1. Remove the old copy from Downloads
+1. Launch VS Code from the Applications folder
+
+This resolves read-only permission issues and allows VS Code to update properly, ensuring the Uno Platform extension functions correctly.
+
+#### VS Code version requirements
+
+The Uno Platform extension requires specific minimum VS Code versions depending on your configuration:
+
+- **Uno Platform extension**: Requires VS Code 1.75.0 or later
+- **C# extension** (OmniSharp mode): Requires VS Code 1.93.0 or later  
+- **C# Dev Kit extension**: Requires VS Code 1.95.0 or later
+
+**To check your VS Code version**:
+1. Open VS Code
+1. Press `F1` and type `Code: Check for Updates...` and select it
+1. Or go to **Help** > **About** to see your current version
+
+**To update VS Code**:
+1. Use the update command above, or
+1. Download the latest version from [https://code.visualstudio.com/](https://code.visualstudio.com/)
+1. Restart VS Code after updating
+
+If the Uno Platform extension doesn't activate after creating a new Uno app, ensure your VS Code version meets these requirements.
+
 The Uno Platform extension provides multiple output windows to troubleshoot its activities:
 
 - **Uno Platform**, which indicates general messages about the extension

doc/articles/get-started-vscode.md

@@ -13,7 +13,9 @@ See these sections for information about using Uno Platform with:
 
 ## Prerequisites
 
-- [**Visual Studio Code**](https://code.visualstudio.com/)
+- [**Visual Studio Code**](https://code.visualstudio.com/) 1.75.0 or later
+  - For **C# extension** (OmniSharp mode): 1.93.0 or later
+  - For **C# Dev Kit**: 1.95.0 or later
 - The [Uno Platform Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=unoplatform.vscode) Extension
 - For Linux, install [OpenJDK 11](https://learn.microsoft.com/java/openjdk/install#install-on-ubuntu) for Android development.
 
@@ -27,6 +29,7 @@ If you are new to VS Code or to developing C# applications with VS Code take the
 
 1. Open VS Code
 1. If this is not a new installation, then try to update it. Press `F1` and type `Code: Check for Updates...` and select it. A notification will tell you if an update is available.
+1. **macOS users**: Ensure VS Code is installed in the Applications folder, not in Downloads. If VS Code is in Downloads, it may run in read-only mode and prevent proper extension functionality. See the [troubleshooting guide](xref:Uno.UI.CommonIssues.vscode) for details.
 1. Configure VS Code to start from the command-line using the `code` command. This can be configured by following [these instructions](https://code.visualstudio.com/docs/editor/command-line#_launching-from-command-line).
 1. Install the **Uno Platform** extension. Press `F1` and type `Extensions: Install Extensions`, search the marketplace for **Uno Platform** and click the **Install** button.
 

doc/articles/uno-build-error-codes.md

@@ -232,3 +232,15 @@ With version 0.14 (and later) you can override the location of `msbuild.exe` by:
 1. Setting the location where your `msbuild.exe` is located
 
 ![settings](Assets/quick-start/vs-code-settings-msbuild.png)
+
+### UVSC0003
+
+The Uno Platform extension requires VS Code version 1.75.0 or later. If you're using the C# extension with OmniSharp, you need VS Code 1.93.0 or later. For C# Dev Kit support, VS Code 1.95.0 or later is required.
+
+To update your VS Code version:
+
+1. Press `F1` and type `Code: Check for Updates...` and select it
+1. Alternatively, download the latest version from [https://code.visualstudio.com/](https://code.visualstudio.com/)
+1. Restart VS Code after updating
+
+**macOS users**: If VS Code is installed in the Downloads folder instead of Applications, it may run in read-only mode and prevent updates. Move VS Code to the Applications folder to resolve this issue.