diff --git a/site/README b/site/README
deleted file mode 100644
index 60b411cb..00000000
--- a/site/README
+++ /dev/null
@@ -1 +0,0 @@
-Jekyll's awesome website.
diff --git a/site/README.md b/site/README.md
new file mode 100644
index 00000000..4e195cab
--- /dev/null
+++ b/site/README.md
@@ -0,0 +1,11 @@
+# Jekyll docs site
+
+This directory contains the code for the Jekyll docs site, [jekyllrb.com](http://jekyllrb.com/).
+
+## Contributing
+
+For information about contributing, see the [Contributing page](http://jekyllrb.com/docs/contributing/).
+
+## Running locally
+
+You can preview your contributions before opening a pull request by running `jekyll serve` from within the directory. It's just a jekyll site, afterall! :wink:
\ No newline at end of file