diff --git a/content/setup/macos.md b/content/setup/macos.md
index c62ea3ee..24017380 100644
--- a/content/setup/macos.md
+++ b/content/setup/macos.md
@@ -4,6 +4,7 @@ prev: /setup
 next: /creating-a-new-project
 contributors:
   - rigor789
+  - sjsadowski
 ---
 
 ## Setting up macOS for Android
@@ -47,6 +48,10 @@ brew tap homebrew/cask-versions
 brew install --cask temurin@17
 ```
 
+:::warning Note
+Using JDK 17 is highly recommended as the nativescript-bundled version of gradle is compatible. Using a newer version of the JDK may cause issues with your android build process.
+:::
+
 Once installed, open a new Terminal and verify that the default version is the one we installed:
 
 ```cli
@@ -150,6 +155,10 @@ Once the installation is complete (this may take a while — brew a coffee a
 
 Open `XCode › Preferences › Locations` and make sure **Command Line Tools** is set
 
+:::warning Note
+In newer versions of XCode, 'Preferences' may be 'Settings'
+:::
+
 ![XCode Preferences, Locations](../assets/images/environment-setup/xcode_command_line_tools.png)
 
 ### Installing Ruby