diff --git a/README.md b/README.md
index 2c15c2dd..7a74052f 100644
--- a/README.md
+++ b/README.md
@@ -2,26 +2,33 @@
 
 A growing library of assorted data structures, algorithms and utilities.
 
-- `orx-integral-image`, a CPU-based implementation for integral images (summed area tables)
+- [`orx-integral-image`](orx-integral-image/README.md), a CPU-based implementation for integral images (summed area tables)
 - `orx-jumpflood`, a filter/shader based implementation of the jump flood algorithm for finding fast approximate (directional) distance fields
 - `orx-kdtree`, a kd-tree implementation for fast nearest point searches
-- `orx-no-clear`, a simple extension that provides drawing without clearing the background
+- [`orx-no-clear`](orx-no-clear/README.md), a simple extension that provides drawing without clearing the background
+
 ## Usage
+ORX is built against OPENRNDR 0.3.28, make sure you use this version in your project. Because OPENRNDR's API is pre 1.0 it tends to change from time to time.
 
-ORX is build against OPENRNDR 0.3.28, make sure you use this version in your project.
+The easiest way to add ORX to your project is through the use of Jitpack. [Jitpack](http://jitpack.io) is a service that pulls Gradle based libraries from Github, builds them and serves the jar files.
 
-Easiest way to add ORX to your project is through the use of Jitpack
-
-Add repository:
+To setup Jitpack support in your project all you have to do is add the Jitpack repository to your `repositories {}`. It is advised to have the jitpack repository as the last entry.
 ```
 repositories {
     maven { url 'https://jitpack.io' }
 }
 ```
 
-Add dependency:
+You can then add any of the ORX artefacts to your `dependencies {}`:
 ```
 dependencies {
     compile 'com.github.openrndr.orx:<orx-artifact>:v0.0.9'
 }
 ```
+
+For example if you want to use the `orx-no-clear` artifact one would use:
+```
+dependencies {
+    compile 'com.github.openrndr.orx:orx-no-clear:v0.0.9'
+}
+```