Update README
diff --git a/README.md b/README.md
index 7b489f6..48994d6 100644
--- a/README.md
+++ b/README.md
@@ -6,4 +6,27 @@
This module is part of the [Apache Sling](https://sling.apache.org) project.
-Command line utility which helps with comparing the artifacts contained by two launchpad instances.
+Command line utility which helps with comparing the artifacts contained by two launchpad/starter instances.
+
+## Usage
+
+This tool expects to be part of a `repo` checkout to generate the changelogs between Sling modules. It is
+recommended to run the following command to make sure all the latest changes are present in the local
+checkout:
+
+ repo forall -c 'git fetch'
+
+Afterwards build and run this project
+
+ mvn clean package
+ java -jar target/launchpad-comparator-0.9.0-SNAPSHOT.jar 10 11-SNAPSHOT
+
+The report will list:
+
+ * added dependencies
+ * removed dependencies
+ * changed dependencies
+
+For Sling artifacts that have changed it will also list the Jira issues which were potentially fixed between
+the releases. It does so by parsing the commit messages, but does not verify that the issues are actually
+fixed.
