update instructions

Author: vherus

README.md

@@ -7,4 +7,23 @@ name in the [settings.gradle](./settings.gradle) file.
 - Sample learning objective
 
 ## Set up instructions
-- Sample instruction
+- Fork this repository and clone the forked version to your machine
+- Open the root directory of the project in IntelliJ
+- Implement the requirements listed in comments in the `./src/main/java/com.booleanuk/Exercise.java` file
+- When ready to test your solution, open the `./src/test/java/com.booleanuk/ExerciseTest.java` file and click a "Run Test" button. You can either run the entire test suite via figure 1 in the screenshot below, or run a specific test via figure 2.
+
+![](./assets/run-a-test.PNG)
+
+## Test Output
+
+When you run a test, it's either going to pass or fail. When it fails, you'll be presented with a big red stream of text. This is called a stack trace and, though intimidating, does contain some useful information.
+
+One of the core skills of a developer is debugging stack traces like this. The stack trace details in which classes & files the failure happened, and gives you a line number at the end. Most of the lines in the stack trace are irrelevant most of the time, you want to try and identify the files that you're actually working with.
+
+In the sample screenshot below, we've tried to complete the first step of the exercise but provided an invalid value. Then we run the test associated with it and we see a big red stack trace, a test failure.
+
+At the top, we see `expected: <32> but was: <33>`. This means the test expected the value to be 32, but the value the student provided was 33. We can see this in the code snippets at the top of the screenshot.
+
+In the stack trace itself, we see this line: `at app//com.booleanuk.ExerciseTest.shouldBeAged32(ExerciseTest.java:20)`. This is helpful! This tells us the exact line in the ExerciseTest.java file (line 20) where the failure happened, as well as the method name (shouldBeAged32), helping us to identify where the issue began. This is the kind of thing you need to look for; a relevant file name, method name, class name and line number to give you a good starting point for debugging.
+
+![](./assets/test-failure.PNG)