diff --git a/gnomeos/README b/gnomeos/README-build.md
similarity index 92%
rename from gnomeos/README
rename to gnomeos/README-build.md
index d3377b0f..3a86b609 100644
--- a/gnomeos/README
+++ b/gnomeos/README-build.md
@@ -63,6 +63,8 @@ sudo make install
 sudo chown root:root /usr/local/bin/linux-user-chroot
 sudo chmod u+s /usr/local/bin/linux-user-chroot
 
+# We're going to be using Yocto.  You probably want to refer to:
+# http://www.yoctoproject.org/docs/current/yocto-project-qs/yocto-project-qs.html
 # Next, we're grabbing my Poky branch.
 
 git clone git://github.com/cgwalters/poky.git
@@ -75,6 +77,8 @@ cd $builddir
 # Now edit conf/bblayers.conf, and add
 #   /src/ostree/gnomeos/yocto
 # to BBLAYERS.
+# remove tools-profile and tools-testapps from EXTRA_IMAGE_FEATURES
+# Also, you should choose useful values for BB_NUMBER_THREADS, PARALLEL_MAKE
 
 bitbake ostree-native
 bitbake gnomeos-contents-{runtime,devel}
diff --git a/gnomeos/README-install.md b/gnomeos/README-install.md
new file mode 100644
index 00000000..74c17439
--- /dev/null
+++ b/gnomeos/README-install.md
@@ -0,0 +1,30 @@
+Overview
+--------
+
+http://ostree.gnome.org is the sole build/deploy server right now.
+
+Notably http://ostree.gnome.org/repo is an OSTree repo which holds
+binaries. 
+
+To install, right now you need to build the 'ostree' git module
+somehow.  I personally use jhbuild, but you could make an RPM/.deb or
+whatever too.
+
+Replace ~/src with whereever you keep source code.
+
+$ cd ~/src
+$ git clone git://git.gnome.org/ostree
+$ cd ostree
+$ jhbuild buildone -nf $(basename $(pwd))
+
+Now we need to run the install script as root.
+
+$ su -
+# ~/src/ostree/gnomeos/yocto/gnomeos-install.sh
+
+Now you may need to edit your GRUB configuration.  This part varies
+for GRUB 1 versus GRUB 2.  The GRUB 2 bits in "15_ostree" don't really
+work yet.  I'm just manually writing GRUB 1 entries.
+
+
+
diff --git a/gnomeos/yocto/README.md b/gnomeos/yocto/README.md
deleted file mode 100644
index 3af3b502..00000000
--- a/gnomeos/yocto/README.md
+++ /dev/null
@@ -1,38 +0,0 @@
-Setup
------
-
-We're going to be using Yocto.  You probably want to refer to:
-http://www.yoctoproject.org/docs/current/yocto-project-qs/yocto-project-qs.html
-
-The first part of this setup just repeats that.
-
-Choose a directory for git sources, and a different directory for
-builds. I use: /src/ for git checkouts, and /src/build for builds.
-
-Get a Yocto checkout:
-
-cd /src
-git clone -b edison git://git.yoctoproject.org/poky.git
-
-mkdir -p /src/build/gnomeos
-cd /src/build/gnomeos
-. oe-init-build-env
-
-If you want at this point, you can run 'bitbake core-image-minimal'
-and you'll get an image bootable in QEMU.  However, our next step
-is to set up the gnomeos layer on top.
-
-You'll need a checkout of ostree:
-
-cd /src
-git clone git://git.gnome.org/ostree
-
-Now, edit /src/build/gnomeos/build/conf/layers.conf
-
-Add /src/ostree/gnomeos/yocto as a layer.  I also recommend editing
-conf/local.conf and doing the following:
-
- * remove tools-profile and tools-testapps from EXTRA_IMAGE_FEATURES
- * choose useful values for BB_NUMBER_THREADS, PARALLEL_MAKE
-
-