[vigetlabs#247] Update site README with more detailed instructions

site/README.md

@@ -1,7 +1,31 @@
 # Microcosm Site
 
-The Microcosm website draws from `../docs` and `./src/content` to
-build pages. It is published to Github Pages here:
+- [Introduction](#introduction)
+- [Setup](#setup)
+- [Run Locally](#run-locally)
+- [Publish](#publish)
+
+## Introduction
+
+The Microcosm website is built using markdown files, html templates, a stylesheet, and a few image assets. Here is a brief overview of everything you'll find in the `site` folder:
+
+### public
+
+The generated site will live here after running (we'll go over generating the site and serving the site locally in the next section.) With the exception of the `assets` folder you should never edit these files, they will be overwritten when regenerating the site and aren't in source control.
+
+### scripts
+
+The `Makefile` uses these files to generate the html files in the `public` folder, to serve the site locally, and to publish the site to Github pages.
+
+### src
+
+
+
+> Note that markdown files are in `../docs` (outside the site folder) and `./src/pages`.
+
+
+
+It is published to Github Pages here:
 
 http://code.viget.com/microcosm/