diff --git a/README.txt b/README.txt
index ab56587..436965d 100644
--- a/README.txt
+++ b/README.txt
@@ -49,16 +49,7 @@ Dagen Brock
 Saturday, January 30, 2016   1:18PM
 --------------------------------------------------------------------------------
 
-Mac OSX Build Instructions
+Build Instructions
 ==========================
-Download the repo
-Install 'brew' if you don't already have it installed.  (Google it, it's easy.)
-Install SDL libraries if needed:
-  brew install sdl2
-Install FreeType if needed:
-  brew install freetype
-Create a symbolic link from the vars_osx file to 'vars':
-  cd src
-  ln -s vars_osx vars
-Build the binary:
-  make clean ; make
+See the /doc/ directory for "Developer-Quickstart" docs which cover building
+for the various platforms.  (as fast as I can write them :P )
diff --git a/doc/Developer-QuickStart-Linux.txt b/doc/Developer-QuickStart-Linux.txt
new file mode 100644
index 0000000..0695714
--- /dev/null
+++ b/doc/Developer-QuickStart-Linux.txt
@@ -0,0 +1,21 @@
+# ubuntu - X11 version
+
+# system prep
+sudo apt-get -y update
+sudo apt-get -y upgrade
+sudo apt-get -y install git
+sudo apt-get -y install g++
+sudo apt-get -y install libpcap0.8-dev
+sudo apt-get -y install libx11-dev
+sudo apt-get -y install libxext-dev
+
+# build
+git clone git@github.com:digarok/gsplus.git
+cd gsplus/src
+ln -s vars_x86linux_x11 vars
+make clean ; make
+
+
+
+
+
diff --git a/doc/Developer-QuickStart-MacOSX.txt b/doc/Developer-QuickStart-MacOSX.txt
new file mode 100644
index 0000000..0bc6951
--- /dev/null
+++ b/doc/Developer-QuickStart-MacOSX.txt
@@ -0,0 +1,27 @@
+# Mac OSX - SDL2 version
+# Install 'brew' if you don't already have it installed. 
+
+# system prep
+brew install sdl2
+brew install freetype
+
+# build
+git clone git@github.com:digarok/gsplus.git
+cd gsplus/src
+ln -s vars_osx_sdl2 vars
+make clean ; make
+
+#Note that installing freetype via brew will install the library, but I think
+# maybe you have to install the source and build it to link it in properly. 
+
+# You could use /usr/local/src instead of /tmp
+cd /tmp 
+curl --remote-name --location http://sourceforge.net/projects/freetype/files/freetype2/2.6.2/freetype-2.6.2.tar.gz
+tar -xzvf freetype-2.6.2.tar.gz
+cd freetype-2.6.2
+./configure --prefix=/usr/local/freetype-2.6.2
+make
+make install
+ln -s freetype-2.6.2 /usr/local/freetype
+
+