diff --git a/tutorials/vscJUnitTesting.md b/tutorials/vscJUnitTesting.md
index 9f6d9059..df98a355 100644
--- a/tutorials/vscJUnitTesting.md
+++ b/tutorials/vscJUnitTesting.md
@@ -8,13 +8,27 @@
# {{ title }}
-This tutorial covers the basics of using VS Code’s JUnit.
+
+This tutorial will help you:
+- Set up JUnit support in a Gradle project using VS Code
+- Write and run your first JUnit test
+- Understand test folder structure and naming conventions
+- View test results and coverage using VS Code
+
+You should already be familiar with Java and Gradle basics before proceeding.
+
## Prerequisites
+
+Ensure you have installed the following extensions in VS Code:
+- **Java Extension Pack** (includes Language Support, Debugger, Maven/Gradle tools)
+- **Test Runner for Java** (for the Testing Explorer and test UI support)
+
+
@@ -26,13 +40,40 @@ This tutorial assumes you are using Gradle to manage JUnit.
-Restart VSCode after updating the `build.gradle` file, to ensure the changes take effect.
+Restart VSCode after updating the build.gradle file, to ensure the changes take effect.
+
+
+ After restarting, check if the beaker **Testing** icon appears in the left sidebar of VS Code.
+This confirms JUnit is correctly configured and detected by the IDE.
+
+
+Here’s what a typical Gradle Java project folder structure looks like:
+
+```text
+your-project/
+├── build.gradle
+├── settings.gradle
+└── src/
+ ├── main/
+ │ └── java/
+ │ └── YourMainClass.java
+ └── test/
+ └── java/
+ └── YourTestClass.java
+```
+
+* Place your actual application code in src/main/java/
+* Place your JUnit test files in src/test/java/
+
+
+
+
@@ -51,8 +92,7 @@ Restart VSCode after updating the `build.gradle` file, to ensure the changes tak
****Using VS Code:****
-* Use the **green play button** next to the class or method to run tests.
- 
+Hover your mouse over the test method or class, then click the **green play button** (▶) that appears to run the test. 
* The Testing Explorer is a tree view to show all the test cases in your workspace.
Open the Testing Explorer by clicking the beaker icon in the left Activity Bar. You can run/debug tests and view their results from there as well.

@@ -67,9 +107,11 @@ Restart VSCode after updating the `build.gradle` file, to ensure the changes tak
+To learn how to write good test cases, refer to [this section of the SE book](https://se-education.org/guides/tutorials/junit.html).
+
---
-**Contributors**: Song Yuexi ([@YosieSYX](https://github.com/YosieSYX))
+**Contributors**: Song Yuexi ([@YosieSYX](https://github.com/YosieSYX)), Arshin Sikka ([@arshinsikka](https://github.com/arshinsikka))