diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 0000000..7121b59
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,3 @@
+script: make clean all
+before_script:
+ - sudo apt-get install asciidoc source-highlight
diff --git a/Makefile b/Makefile
index 2402627..804fb66 100644
--- a/Makefile
+++ b/Makefile
@@ -4,11 +4,15 @@
 
 HTML = federation-am-api.html
 
-all: $(HTML)
+all: checker $(HTML)
 
 clean:
 	rm -f $(HTML)
 
+checker:
+	@bin="asciidoc" && command -v $$bin > /dev/null || (echo "ERROR: Please install '$$bin' first." && exit 1)
+	@bin="source-highlight" && command -v $$bin > /dev/null || (echo "ERROR: Please install '$$bin' first." && exit 1)
+
 %.html: %.adoc
 	asciidoc -a theme=compact -a data-uri -a icons -a toc2 $(<F)
 
diff --git a/README.md b/README.md
index 60139f0..f8e8a4c 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,29 @@
-federation-am-api
+Federation AM API
 =================
 
-Standardisation spec of the Federation Aggregate Manager API for testbeds
+[![Build Status](https://travis-ci.org/tubav/federation-am-api.svg?branch=master)](https://travis-ci.org/tubav/federation-am-api)
+
+Standardisation spec of the Federation Aggregate Manager API for testbeds.
+
+Setup
+-----
+
+* OS X
+```bash
+    $ brew install asciidoc source-highlight
+```
+* Ubuntu
+```bash
+    $ apt-get install asciidoc source-highlight
+```
+
+Run
+---
+* OS X
+```bash
+    $ make clean all && open federation-am-api.html
+```
+* Ubuntu
+```bash
+    $ make clean all && xdg-open federation-am-api.html
+```