diff --git a/jOOQ-examples/jOOQ-spring-example/README.md b/jOOQ-examples/jOOQ-spring-example/README.md
new file mode 100644
index 0000000000..35cffc8d64
--- /dev/null
+++ b/jOOQ-examples/jOOQ-spring-example/README.md
@@ -0,0 +1,19 @@
+Thanks for downloading jOOQ.
+Please visit http://www.jooq.org for more information.
+
+This example was inspired by Petri Kainulainen's excellent blog post:
+http://www.petrikainulainen.net/programming/jooq/using-jooq-with-spring-configuration/
+
+To install and run this example, please check out the complete jOOQ repository first, and use Maven to install the latest SNAPSHOT version of jOOQ:
+
+```
+$ pwd
+/path/to/checkout/dir
+$ ls
+jOOQ jOOQ-meta jOOQ-codegen ...
+$ mvn clean install
+...
+$ cd jOOQ-examples/jOOQ-spring-example
+...
+$ mvn clean install
+```
diff --git a/jOOQ-examples/jOOQ-spring-example/README.txt b/jOOQ-examples/jOOQ-spring-example/README.txt
deleted file mode 100644
index bf250b0c0c..0000000000
--- a/jOOQ-examples/jOOQ-spring-example/README.txt
+++ /dev/null
@@ -1,5 +0,0 @@
-Thanks for downloading jOOQ.
-Please visit http://www.jooq.org for more information.
-
-This example was inspired by Petri Kainulainen's excellent blog post:
-http://www.petrikainulainen.net/programming/jooq/using-jooq-with-spring-configuration/
\ No newline at end of file