diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..451c8f2c22faf733de2937e2c036749466abc755
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# CiviCRM developer documentation
+
+This will likely be merged with the civicrm-core repo at some point.
+
+See https://github.com/civicrm/civicrm-docs for more information on contributing.
+
+This repository can be previewed at http://docs.civicrm.org/dev/en/master.
diff --git a/mkdocs.yml b/mkdocs.yml
new file mode 100644
index 0000000000000000000000000000000000000000..477137d647412bfe340b1d8a3d4d2f22f90d3652
--- /dev/null
+++ b/mkdocs.yml
@@ -0,0 +1,2 @@
+site_name: CiviCRM developer documentation
+theme: readthedocs