thodg/libgit2

diff --git a/examples/README.md b/examples/README.md
index 38d1ed8..f2b6d7d 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -1,8 +1,11 @@
 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.
+These examples are meant as thin, easy-to-read snippets for Docurium
+(https://github.com/github/docurium) rather than full-blown
+implementations of Git commands.  They are not vetted as carefully
+for bugs, error handling, or cross-platform compatibility as the
+rest of the code in libgit2, so copy with some caution.
+
+For HTML versions, check "Examples" at http://libgit2.github.com/libgit2
 
-For a HTML version check "Examples" at http://libgit2.github.com/libgit2