diff --git a/README.md b/README.md
index 1c8fd30f16..5e61f8a782 100644
--- a/README.md
+++ b/README.md
@@ -25,8 +25,15 @@ Atrium can be retrieved from [bintray](https://bintray.com/robstoll/tutteli-jars
 
 gradle: 
 ```
-testCompile 'ch.tutteli:atrium-api:0.2.0'
-testCompile 'ch.tutteli:atrium-impl-robstoll:0.2.0'
+buildscript {
+    ext { atrium_version='0.2.0' }
+}
+
+dependencies {
+    testCompile "ch.tutteli:atrium-api:$atrium_version"
+    testCompile "ch.tutteli:atrium-impl-robstoll:$atrium_version"
+    testCompile "ch.tutteli:atrium-assertions:$atrium_version"
+}
 ```
 
 maven:
@@ -43,6 +50,12 @@ maven:
   <version>0.2.0</version>
   <scope>test</scope>
 </dependency>
+<dependency>
+  <groupId>ch.tutteli</groupId>
+  <artifactId>atrium-assertions</artifactId>
+  <version>0.2.0</version>
+  <scope>test</scope>
+</dependency>
 ```
 
 # Use own Assertion Verbs
@@ -66,9 +79,16 @@ If you still insist of using the provided assertion verbs, then add the followin
 
 gradle:
 ```
-testCompile 'ch.tutteli:atrium-api:0.2.0'
-testCompile 'ch.tutteli:atrium-impl-robstoll:0.2.0'
-testCompile 'ch.tutteli:atrium-verbs:0.2.0'
+buildscript {
+    ext { atrium_version='0.2.0' }
+}
+
+dependencies {
+    testCompile "ch.tutteli:atrium-api:$atrium_version"
+    testCompile "ch.tutteli:atrium-impl-robstoll:$atrium_version"
+    testCompile "ch.tutteli:atrium-assertions:$atrium_version"
+    testCompile "ch.tutteli:atrium-verbs:$atrium_version"
+}
 ```
 
 maven:
@@ -85,6 +105,12 @@ maven:
   <version>0.2.0</version>
   <scope>test</scope>
 </dependency>
+<dependency>
+  <groupId>ch.tutteli</groupId>
+  <artifactId>atrium-assertions</artifactId>
+  <version>0.2.0</version>
+  <scope>test</scope>
+</dependency>
 <dependency>
   <groupId>ch.tutteli</groupId>
   <artifactId>atrium-verbs</artifactId>
@@ -131,8 +157,8 @@ expect {
 }.toThrow<IllegalStateException> {
     message.contains("name")
 }
-    // expect to throw: IllegalStateException (java.lang.IllegalStateException)
-    // exception was: IllegalArgumentException (java.lang.IllegalArgumentException)
+    // expect the thrown exception: IllegalStateException (java.lang.IllegalStateException)
+    // is a: IllegalArgumentException (java.lang.IllegalArgumentException)
 ```
 
 Have a look at the [specifications](./tree/master/atrium-spec/src/main/kotlin/ch/tutteli/atrium/spec) for more examples.