diff --git a/README.md b/README.md
index 6d2a174..b55053e 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,50 @@
-Solarized Colorscheme for IDEA
-==============================
+Solarized Colorscheme for IntelliJ IDEA
+=======================================
 
-### [See official homepage for full content](http://ethanschoonover.com/solarized)
-### [IntelliJ IDEA homepage](http://www.jetbrains.com/idea/)
+Original Solarized color scheme developed by Ethan Schoonover <es@ethanschoonover.com>
+
+Adapted for IntelliJ IDEA by:
+Adam Vandenberg <flangy@gmail.com>
+Johan Kaving <johan@kaving.se>
+
+Visit the [Solarized homepage]
+------------------------------
+
+See the [Solarized homepage] for screenshots, 
+details and colorscheme versions for Vim, Mutt, popular terminal emulators and 
+other applications.
+
+Downloads
+---------
+
+If you have come across this colorscheme via the [IntelliJ-only repository] on 
+github see the link above to the Solarized homepage or visit the main [Solarized repository].
+
+The [IntelliJ-only repository] is kept in sync with the main [Solarized repository].
+Issues, bug reports, changelogs are centralized at the main [Solarized repository].
+
+[Solarized homepage]:   http://ethanschoonover.com/solarized
+[Solarized repository]: https://github.com/altercation/solarized
+[IntelliJ-only repository]:  https://github.com/jkaving/intellij-colors-solarized
 
 Installation
 ------------
 
-These files were exported from IntelliJ IDEA 10 using `File | Export Settings...`.
-Presumably `File | Import Settings...` could be used to read them back in.
+1.  Copy `Solarized Dark.xml` and `Solarized Light.xml` to your IntelliJ IDEA preferences
+color directory.
+On Mac OS X this is typically located in `~/Library/Preferences/IntelliJIdea10/colors` or `~/Library/Preferences/IntelliJIdea10CE/colors` (for the Community Edition).
+On Windows it is in `Documents and Settings/<user>/.IntelliJIdea10/config/colors`
+        
+2. Restart IntelliJ IDEA
 
-Note that font settings come along with the color settings, unfortunately.
+3. Go to `Preferences | Editor | Colors & Fonts` and select one of the new 
+color themes.
 
-Only a Solarized Dark scheme is provided so far.
-
-Your color schemes are likely located in `~/Library/Preferences/IntelliJIdea10/colors`.
+Note About Fonts
+-----------------
+Unfortunately, font settings are included in the color settings files.
+You should probably modify these in `Preferences | Editor | Colors & Fonts | Font`
+after adding the color schemes to your IntelliJ IDEA installation.
 
 
 The Values