diff --git a/README.md b/README.md
index b5da1460c56a711980fa33c1710facf1fc2768a7..95c8efaf10f6e8c4bba7d1cce3ea4dc8597998f6 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
 # SWEN90006-A1-2018
 
-Assignment code for SWEN90006 (Software Testing and Reliability) at the University of Melbourne. Semester 2, 2018.
\ No newline at end of file
+Assignment code for SWEN90006 (Software Testing and Reliability) at the University of Melbourne. Semester 2, 2018.
+
+The folder structure is:
+
+- src/ contains the source code for the virtual machine.
+- test/ contains the templates for the JUnit test scripts.
+- mutants/ contains five identical copies of the src, which you must modify to create your mutants.
+- examples/ contains two example programs using the simple language.
+- build.xml is an ant build script that you can choose to use or not