examples: add README
diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 0000000..38d1ed8
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,8 @@
+libgit2 examples
+================
+
+These examples might don't work on all platforms and are meant as thin,
+easy-to-read snippets for docurium (https://github.com/github/docurium)
+rather than full-blown implementations of Git commands.
+
+For a HTML version check "Examples" at http://libgit2.github.com/libgit2