diff --git a/index.md b/index.md
index be0d4e50..7ac03b21 100644
--- a/index.md
+++ b/index.md
@@ -34,6 +34,7 @@ Tutorials, how-to guides, getting-started guides, ...
   * [Configuring the code style](tutorials/intellijCodeStyle.html)
   * [Using the debugger](tutorials/intellijDebugger.html)
   * [Useful settings](tutorials/intellijUsefulSettings.html)
+* [**Visual Studio Code**](tutorials/vscode.html)
 * [**Sourcetree**](tutorials/sourcetree.html)
 * **Testing**
   * [Automated testing of text UIs](tutorials/textUiTesting.html)
diff --git a/tutorials/images/vscode/vscode_gradle_icon.jpg b/tutorials/images/vscode/vscode_gradle_icon.jpg
new file mode 100644
index 00000000..b7d0eb51
Binary files /dev/null and b/tutorials/images/vscode/vscode_gradle_icon.jpg differ
diff --git a/tutorials/vscode.md b/tutorials/vscode.md
index 51faeb94..bd07e600 100644
--- a/tutorials/vscode.md
+++ b/tutorials/vscode.md
@@ -1,14 +1,55 @@
 {% set title="VS Code - Community Resources" %}
 <frontmatter>
   title: "{{ title }}"
-  pageNav: 0
+  pageNav: 2
 </frontmatter>
 
-# {{ title }}
 
-<box type="warning">
+<box type="warning" light>
+
+**Caution: This page is a work-in-progress, containing content contributed by students.**
 
-This page contains **'community resources' contributed by students**.
+* If you notice any bugs or suggestions for improvements, please report at https://github.com/se-edu/guides/issues
+* You are welcome to contribute by sending a PRs to https://github.com/se-edu/guides/pulls too.
 </box>
 
-Coming soon ...
\ No newline at end of file
+# {{ title }}
+
+This guide is for those who prefer to use [Visual Studio Code](https://code.visualstudio.com/) (VS Code) for their Java projects.
+
+## Preparing VS Code for Java projects
+
+1. Install the JDK needed for your project, as given [here](javaInstallation.md).<br>
+   IMPORTANT: If you are on a Mac and you anticipate using JavaFX in your projects, you are using the precise JDK specified [here](javaInstallationMac.md).
+1. Install the [Extension Pack for Java](https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-pack) extension to enable support for Java extensions, if you haven't done so already.<br>
+   i.e., Go to `Extensions` → Search `Extension Pack for Java` → Install.
+
+## Importing a Gradle project
+
+* **Verify the project has support for Gradle:** If it does, you will see a `build.gradle` file in your project root.{{ step_numbers }}
+* **Open the project in VS Code**, as follows:
+  * Open VS Code.{{ abcd_numbers }}
+  * If you are in the welcome screen, Click `Open`. Otherwise, click `File` -> `Open`.
+  * Select the project directory, and click `Open`.
+* **Confirm the correct JDK is set** to the one you are supposed to use for the project, as follows:
+  * Open the Command Palette: {{ icon_windows }}/{{ icon_linux}} `Ctrl+Shift+P` | {{ icon_apple }} `Cmd+Shift+P` {{ abcd_numbers }}
+  * Type `Java: Configure Java Runtime` and select it.
+  * Check that the JDK version matches the one required for your project. If not, you can install the required JDK and configure it. (Java installation guides: [Windows](https://se-education.org/guides/tutorials/javaInstallationMac.html) | [Mac](https://se-education.org/guides/tutorials/javaInstallationWindows.html))
+* **Confirm the correct JVM is used for Gradle**, as follows:
+  * Install the Gradle Extension: Search for `Gradle` in the Extensions view (`Ctrl+Shift+X` or `Cmd+Shift+X`), and install a Gradle extension if you haven’t already (e.g., [Gradle for Java](https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-gradle)). {{ abcd_numbers }}
+  * Open `settings.json`: You can find it by opening the Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`), then typing `Preferences: Open User Settings (JSON)`.
+  * Add or modify the following settings to configure the JVM for Gradle. Here's an example (for Mac):
+    ```json { heading="settings.json" }
+    {
+      "java.configuration.runtimes": [
+        {
+          "name": "JavaSE-17",
+          "path": "/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home"
+        }
+      ],
+      "java.import.gradle.java.home": "/Library/Java/JavaVirtualMachines/zulu-11.jdk/Contents/Home"
+    }
+    ```
+  * If the Gradle icon doesn't appear after restarting VS Code, add `"gradle.nestedProjects": true` to your `settings.json` file.
+* **Confirm you can access the Gradle tool window**. After the importing of the project is complete (which could take a few minutes), you will see the Gradle Tab in the VSCode interface e.g., look for the elephant icon on the left and click it.<br>
+   <pic src="images/vscode/vscode_gradle_icon.jpg" width="400" />