update guide to recommend clang

Author: dankmeme01

assets/vs_installer.png

@@ -13,19 +13,30 @@ To be able to use the Geode SDK, you **will** need at least the following:
 ## Compiler
 
 To use the Geode SDK, and in turn make Geometry Dash mods, you will need either:
- * [Visual Studio 2022+](#windows) on Windows
+ * [Clang](#windows-clang) (recommended) or [Visual Studio 2022+](#windows-visual-studio) on Windows
  * [Clang](#macos) on MacOS
  * [A secret third thing](#linux) on Linux
 
-### Windows
+### Windows (Clang)
 
-Download Visual Studio from [its website](https://visualstudio.microsoft.com/downloads/). If you want **just** the compiler and not the code editor, look for *Build Tools for Visual Studio* further down in the page.
+First, install [LLVM](https://github.com/llvm/llvm-project) and [Ninja](https://github.com/ninja-build/ninja). The easiest way is using Scoop:
+```
+scoop install llvm ninja
+```
 
-After launching the installer, select **Desktop development with C++**. You may choose other features, but you **will** need at least ***MSVC*** and ***Windows SDK*** installed.
+LLVM itself does not come with Windows SDK and CRT libraries, so you will need a minimal Visual Studio install for these, which is described in the next section.
 
-Once Visual Studio is installed, you should now have a working C++ compiler that is suited for GD mod development.
+### Windows (Visual Studio)
+
+Please note that Visual Studio **2022** or higher is required. If you have an older version already installed, you should upgrade to the latest available.
 
-Please note that Visual Studio **2022** or higher is required. 2019 or lower will not work, as they don't support C++20 properly.
+Unless you want to install Visual Studio (the editor) itself, we recommend installing just the build tools. Open the VS [download page](https://visualstudio.microsoft.com/downloads), scroll to the bottom, and under "Tools for Visual Studio" download **Build Tools for Visual Studio**.
+
+After launching the installer, select **Desktop development with C++** and optionally deselect all features except for **MSVC Build Tools** and **Windows SDK**, like on the screenshot below. Click Install and wait for it to finish.
+
+![Image showing VS installer](/assets/vs_installer.png)
+
+Once Visual Studio is installed, you should now have a working C++ compiler that is suited for GD mod development.
 
 ### MacOS
 

getting-started/cpp-stuff.md

@@ -19,26 +19,39 @@ You can use one of the following IDEs for developing Geode mods. Using an IDE is
 
 ## VSCode on Windows
 
-For VS Code, we recommend a few extensions:
- * [`C/C++`](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools)
+Install the following VSCode extensions:
  * [`CMake Tools`](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools)
  * [`Geode`](https://marketplace.visualstudio.com/items?itemName=GeodeSDK.geode) - Not required, but will provide some nice features.
 
+As well as one of:
+ * [`clangd`](https://marketplace.visualstudio.com/items?itemName=llvm-vs-code-extensions.vscode-clangd) - **if using Clang as compiler**
+ * [`C/C++`](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools) - **if using MSVC / Visual Studio as compiler**
+
 There are a few steps you should follow to get proper intellisense and code completion (you should only need to do these once per project, ideally):
 
-1. With VS Code open on your project, press F1 and run `CMake: Select a Kit`. This will bring up a list of installed compilers on your machine.
+1. With VS Code open on your project, press F1 and run `CMake: Select a Kit`. This will bring up a list of installed compilers on your machine. This will also open automatically whenever opening a new project.
 
 ![Image showing a bunch of compilers CMake detected in VS Code](/assets/win_compilers.png)
 
-You should pick a **Visual Studio 2022+** compiler (specifically the `amd64` version), or Clang, but nothing else!
-
-> :warning: Please pay attention to this
+Depending on which compiler you want to use, pick either:
+ * **Clang** (not `Clang-cl`) - recommended
+ * **Visual Studio 20xx Release - amd64** (not `amd64_x86` or any other ones)
 
-2. Now to select the build variant, press F1 and run `CMake: Select Variant`. We recommend **RelWithDebInfo** for easier debugging, as Debug may sometimes cause obscure crashes.
+2. Now to select the build variant, press F1 and run `CMake: Select Variant`. We recommend **RelWithDebInfo** for easier debugging, as **Debug** may sometimes cause obscure crashes.
 
 ![Image showing available build types on Windows: Debug, Release, MinSizeRel, and RelWithDebInfo](/assets/win_relwithdebinfo.png)
 
-3. Register CMake as the **Configuration Provider** for the C++ extension by pressing F1 and running `C/C++: Edit Configurations (UI)`. Scroll down to **Advanced** options, and set the Configuration Provider as `ms-vscode.cmake-tools`.
+3. If using **Clang** with the **clangd** extension, press F1 and run `CMake: Edit User-Local CMake Kits`. This will open a file, in there find the chosen kit (one with Clang in the name) and add these keys to it:
+```json
+"cmakeSettings": {
+    "CMAKE_EXPORT_COMPILE_COMMANDS": 1
+},
+"preferredGenerator": {
+    "name": "Ninja"
+}
+```
+
+4. If instead of Clang you chose the **C/C++ extension**, you need to register CMake as the **Configuration Provider** for the C++ extension by pressing F1 and running `C/C++: Edit Configurations (UI)`. Scroll down to **Advanced** options, and set the Configuration Provider as `ms-vscode.cmake-tools`.
 
 ![Image showing the "C/C++: Edit Configurations (UI)" command being run in VS Code](/assets/win_usecmake.png)