diff --git a/.rspec b/.rspec
new file mode 100644
index 0000000..3622215
--- /dev/null
+++ b/.rspec
@@ -0,0 +1,3 @@
+--color
+--format documentation
+--order random
diff --git a/README b/README
deleted file mode 100644
index e69de29..0000000
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1591d67
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+Rubella heatmap library
+=======================
+
+Rubella is a library to generate heatmaps to monitor visualize measured values
+easier. Like the load of multiple CPU cores over time.
+
+Therefore every CPU core gets its own JSON array over the measured time. So the
+array gets it's own row in the headmap. The more the color itensity the higher
+is the load.
+(The values are in percent. So they must be beween 0 and 100.)
+
+During the time you can see, if an unusual behavior occurs, because the image
+shows a different load distribution.
+
+see also: 
+http://dtrace.org/blogs/brendan/2011/12/18/visualizing-device-utilization/
+
+Usage
+-----
+
+Coming soon.