diff --git a/README.md b/README.md
index fd24468..afae52e 100644
--- a/README.md
+++ b/README.md
@@ -57,20 +57,10 @@ Directory structure
 Programming (over USB)
 ------
 
-Programming the STM32
-```
-cd board
-./get_sdk.sh
-make recover   # initially
-make           # future
-```
+[Programming the Board (STM32)](board/README.md)
+
+[Programming the ESP](boardesp/README.md)
 
-Programming the ESP
-```
-cd boardesp
-./get_sdk.sh
-make
-```
 
 Debugging
 ------
diff --git a/board/README b/board/README
deleted file mode 100644
index 3aa8a2b..0000000
--- a/board/README
+++ /dev/null
@@ -1,9 +0,0 @@
-== Building ==
-
-./get_sdk.sh
-
-dfu-util from 
-git@github.com:dsigma/dfu-util.git
-
-
-
diff --git a/board/README.md b/board/README.md
new file mode 100644
index 0000000..c67e3d3
--- /dev/null
+++ b/board/README.md
@@ -0,0 +1,33 @@
+Dependencies
+--------
+
+**Mac**
+
+```
+./get_mac_sdk.sh
+```
+
+**Debian / Ubuntu**
+
+```
+./get_sdk.sh
+```
+
+
+Programming
+----
+
+**Panda**
+
+```
+make
+```
+
+**NEO**
+
+```
+make -f Makefile.legacy
+```
+
+
+[dfu-util](http://github.com/dsigma/dfu-util.git) for flashing
diff --git a/boardesp/README.md b/boardesp/README.md
new file mode 100644
index 0000000..6ceeecc
--- /dev/null
+++ b/boardesp/README.md
@@ -0,0 +1,22 @@
+
+Dependencies
+-----
+
+**Mac**
+
+```
+./get_sdk.sh
+```
+
+**Debian / Ubuntu**
+
+```
+./get_mac_sdk.sh
+```
+
+Programming
+-----
+
+```
+make
+```