diff --git a/README.adoc b/README.adoc
deleted file mode 100644
index 9b0795a..0000000
--- a/README.adoc
+++ /dev/null
@@ -1,3 +0,0 @@
-= Items database
-
-include::doc/index.adoc[lines=3..]
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a4c0b02
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# Items database
+
+An approach to implement a cmdb on steroids as a bunch of linked objects.
+
+It's about object schemas, types and typed links to describe the world as
+dependency graph.
+
+For further information see the [Items database
+documentation](https://code.matthiess.it/collaboration/itemsdb-doc).
+