diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9362d90
--- /dev/null
+++ b/README.md
@@ -0,0 +1,11 @@
+If you want to work on this repo, you can preview the site as you work.
+
+Linux Mint / Ubuntu instructions:
+
+```
+git clone git@github.com:pi-hole/docs.git
+cd docs
+sudo pip install mkdocs
+sudo pip install mkdocs-material
+mkdocs serve
+```
diff --git a/readme.md b/readme.md
deleted file mode 100644
index d4b23b5..0000000
--- a/readme.md
+++ /dev/null
@@ -1,3 +0,0 @@
-See http://www.mkdocs.org/ for instructions on how to edit/build this site
-
-Work in progress!!!
\ No newline at end of file