.all-contributorsrc

@@ -1465,6 +1465,62 @@
       "contributions": [
         "code"
       ]
+    },
+    {
+      "login": "Rishab87",
+      "name": "Rishab Kumar Jha",
+      "avatar_url": "https://avatars.githubusercontent.com/u/138858208?v=4",
+      "profile": "https://github.com/Rishab87",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "yehiarasheed",
+      "name": "Yehia Rasheed",
+      "avatar_url": "https://avatars.githubusercontent.com/u/157399068?v=4",
+      "profile": "https://github.com/yehiarasheed",
+      "contributions": [
+        "code"
+      ]
+    },
+    {
+      "login": "babaissarkar",
+      "name": "Subhraman Sarkar",
+      "avatar_url": "https://avatars.githubusercontent.com/u/8469888?v=4",
+      "profile": "https://github.com/babaissarkar",
+      "contributions": [
+        "code",
+        "a11y"
+      ]
+    },
+    {
+      "login": "SushantBansal-tech",
+      "name": "SushantBansal-tech",
+      "avatar_url": "https://avatars.githubusercontent.com/u/189839531?v=4",
+      "profile": "https://github.com/SushantBansal-tech",
+      "contributions": [
+        "ideas",
+        "code"
+      ]
+    },
+    {
+      "login": "Konsl",
+      "name": "Konsl",
+      "avatar_url": "https://avatars.githubusercontent.com/u/82901383?v=4",
+      "profile": "https://github.com/Konsl",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "marioguzzzman",
+      "name": "Mario Guzman",
+      "avatar_url": "https://avatars.githubusercontent.com/u/7597610?v=4",
+      "profile": "http://www.mario-guzman.com",
+      "contributions": [
+        "doc"
+      ]
     }
   ],
   "repoType": "github",

BUILD.md

@@ -8,6 +8,8 @@ First, [download the IntelliJ IDEA Community Edition](https://www.jetbrains.com/
 
 1. Clone the Processing4 repository to your machine locally
 1. Open the cloned repository in IntelliJ IDEA CE
+1. When prompted, select **Trust Project**. You can preview the project in Safe Mode but you won't be able to build Processing.
+1. IntelliJ may start loading Gradle dependencies automatically. Wait for this process to complete.
 1. In the main menu, go to File > Project Structure > Project Settings > Project.
 1. In the SDK Dropdown option, select a JDK version 17 or Download the jdk
 1. Click the green Run Icon in the top right of the window. This is also where you can find the option to debug Processing. 
@@ -31,7 +33,7 @@ Processing consists of three main components: `Core`, `Java`, and `App`. The `Co
 
 - **Java**: The part of Processing that compiles and runs `.pde` files. It supports different *modes* which implement support for different languages or versions of Processing. The default mode is `Java`.
 
-- `App`: This is the Processing Development Environment (PDE), the visual part of the editor that you see and work within when you use Processing.
+- **App**: This is the Processing Development Environment (PDE), the visual part of the editor that you see and work within when you use Processing.
 
 
 ### Examples
@@ -59,3 +61,37 @@ The main task to run or debug the PDE is `run`. That means you just need to run
 If your main concern is with the `Core` you don't need to build and start the whole PDE to test your changes. In IntelliJ IDEA you can select any of the sketches in `core/examples/src/.../` to run by click on the green arrow next to their main functions. This will just compile core and the example sketch. Feel free to create additional examples for your new functionality.
 
 ## Other editors
+
+## Troubleshooting and Setup Tips (IntelliJ IDEA)
+
+If you’re building Processing using IntelliJ IDEA and something’s not working, here are a few things that might help:
+
+### Use the Correct JDK (temurin-17)
+
+Make sure IntelliJ is using **temurin-17**, not another version. Some users have reported issues with ms-17.
+
+1. Go to **File > Project Structure > Project**
+2. Set the **Project SDK** to:    `temurin-17 java version "17.0.15"`
+
+![JDK Selection](.github/media/troubleshooting-Intellij-setting-djk-version-manually.png)
+
+If it is not already installed, you can download it by:
+1. Clicking the SDK input field and then selecting the `Download JDK...` option from the menu
+2. Select Version: `17`, Vendor: `Eclipse Temurin (AdoptOpenJDK HotSpot)`
+
+
+![JDK Download](.github/media/troubleshooting-Intellij-download-jdk.png)
+
+Now go back to your main window and
+1. Click the green Run Icon in the top right of the window.
+
+
+### “Duplicate content roots detected”
+
+You may see this warning in IntelliJ:
+
+> `Duplicate content roots detected: '.../processing4/java/src'`
+
+This happens because multiple modules reference the same source folder. It’s safe to ignore.
+
+