diff --git a/docs/source/coding/ides/vscode/setup_mac.rst b/docs/source/coding/ides/vscode/setup_mac.rst
index e939d45..ccfbf59 100644
--- a/docs/source/coding/ides/vscode/setup_mac.rst
+++ b/docs/source/coding/ides/vscode/setup_mac.rst
@@ -270,6 +270,20 @@ assumes you have Clang and are creating a Clang kit.
    
    Step 4. Add ``"toolchainFile": "<path/to/the/toolchain>"`` to your kit.
 
+.. note::
+
+   If you have ninja installed (``brew install ninja``) we strongly
+   recommend adding it to your kit by adding the lines:
+
+   .. code-block::
+
+      "preferredGenerator": {
+        "name": "Ninja"
+      },
+      "environmentVariables": {
+        "PATH": "/opt/homebrew/bin;${env:PATH}"
+      }
+
 Configuring a Project
 =====================
 
@@ -425,4 +439,4 @@ Troubleshooting
   For me this was caused by a credentials issue. I simply ran ``git push`` from
   the VSCode terminal (in the root directory of the repo) and gave permission
   to VSCode to use my passwords. From that point forward commit and 
-  synchronization worked fine from VSCode.
\ No newline at end of file
+  synchronization worked fine from VSCode.