diff --git a/readme.org b/readme.org
new file mode 100644
index 0000000..0770cf3
--- /dev/null
+++ b/readme.org
@@ -0,0 +1,21 @@
+#+TITLE: Development environment setup
+#+AUTHOR: James Blair
+#+EMAIL: mail@jamesblair.net
+#+DATE: 1st September 2019
+
+* Introduction
+
+  This document captures my standard development environment for future replication
+  and aims to make it as easy as possible to setup and use.
+
+  The environment is based on Windows 10 using [[https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux][Windows Subsystem for Linux]] for a 
+  command line interface.
+
+  For pair programming I rely on [[https://www.gnu.org/software/emacs/][emacs]], specifically [[https://github.com/syl20bnr/spacemacs][spacemacs]] with [[https://tmate.io/][tmate]].
+
+  This documentation is split into two main sections:
+  - [[windows-setup.org][Windows 10]]
+  - [[wsl-setup.org][Windows Subsystem for Linux]]
+
+
+