diff --git a/README.md b/README.md
index f035992..500e0ce 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,23 @@ A precision colorscheme for machines and people. Available in formats for:
 * OS X Terminal.app
 * Xresources / Xdefaults
 
+Download
+--------
+
+Downloads, screenshots and more information is available from the project 
+homepage: <http://ethanschoonover.com/solarized>.
+
+The git repository is at: https://github.com/altercation/solarized
+
+The vim-only colorscheme (Pathogen ready) is available at: (https://github.com/altercation/vim-colors-solarized
+
+The mutt-only variants can be cloned from https://github.com/altercation/mutt-colors-solarized
+
+Note that through the magic of 
+[git-subtree](https://github.com/apenwarr/git-subtree) these repositories are 
+all kept in sync, so you can pull any of them and get the most up-to-date 
+version.
+
 What
 ----
 
@@ -30,12 +47,12 @@ Features
 
 1. **Selective contrast**
 
-    Solarized reduces brightness based contrast in general. Our display devices
-    today are capable of blasting retina clean off with max brightness and 
-    I found my eyes growing tired using high contrast colorschemes, even with 
-    the brightness turned down. Solarized reduces *brightness contrast* but, 
-    unlike many low contrast colorschemes, retains *contrasting hues* (based on 
-    colorwheel relations) for syntax highlighting readability.
+    Solarized reduces brightness based contrast in general. Modern display 
+    devices are capable of blasting your retina clean off with max brightness 
+    and I found my eyes growing tired using high contrast colorschemes, even 
+    with the brightness turned down. Solarized reduces *brightness contrast* 
+    but, unlike many low contrast colorschemes, retains *contrasting hues* 
+    (based on colorwheel relations) for syntax highlighting readability.
 
 2. **Dual modes: Dark/Light**
 
@@ -60,10 +77,27 @@ Features
     good supporting actor, it keeps the story moving without chewing up the 
     scenery.
 
-Why
----
+5.  **Precision**
 
-How
----
+    The monotones have symmetric CIELAB lightness differences, so switching 
+    from dark to light mode retains the same perceived contrast in brightness 
+    between each value. Each mode is equally readable. The accent colors are 
+    based off specific colorwheel relations and subsequently translated to 
+    CIELAB to ensure perceptual uniformity in terms of lightness. The hues 
+    themselves, as with the monotone \*A\*B values, have been adjusted within 
+    a small range to achieve the most pleasing combination of colors.
+
+Download
+--------
+
+
+
+Installation
+------------
+
+Installation instructions for each version of the colorscheme is included in 
+the subdirectory's README. Note that for Vim (and possibly for Mutt) you may 
+want to clone the specific repository (for instance if you are using Pathogen).  
+See the links at the top of this file.
 
 [CIELAB](http://en.wikipedia.org/wiki/Lab_color_space)