diff --git a/README.md b/README.md
deleted file mode 100644
index 4c5fae0..0000000
--- a/README.md
+++ /dev/null
@@ -1,8 +0,0 @@
-# Beamer Color Theme Solarized
-
-A color theme for Beamer using the
-[Solarized](http://ethanschoonover.com/solarized) palette, and
-inspired by the css stylesheet of
-[ethanshoover.com](https://github.com/altercation/ethanschoonover.com/blob/master/resources/css/style.css).
-
-
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..5c81d7b
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,77 @@
+Beamer Color Theme Solarized
+===============================
+
+A color theme for `Beamer
+<http://www.ctan.org/tex-archive/macros/latex/contrib/beamer/>`_ using
+the `Solarized <http://ethanschoonover.com/solarized>`_ palette, and
+inspired by the css stylesheet of `ethanshoover.com
+<https://github.com/altercation/ethanschoonover.com/blob/master/resources/css/style.css>`_.
+
+See the `Solarized homepage <http://ethanschoonover.com/solarized>`_
+and its `github page
+<https://github.com/altercation/ethanschoonover.com>`_ more
+information about the color palette and themes for Vim, Mutt, and
+Emacs among others.
+
+Installation
+===============
+
+Get the theme from https://github.com/jrnold/beamercolortheme 
+
+Documentation
+================
+
+To load the color theme, add the following to your LaTeX document.
+
+::
+
+  \usecolortheme[<options>]{solarized}
+
+The following *<options>* may be given
+
+- `light` Use the light theme (default).
+- `dark` Use the dark theme.
+- `accent=`*<color>*. The accent color. *<color>* can be `yellow`
+    (default), `orange`, `red`, `magenta`, `violet`, `blue`, `cyan`,
+    `green`.
+
+
+In addition to the beamer colors that it sets, this package defines
+colors which can be used elsewhere.
+ 
+The package defines the sixteen colors of the Solarized palette.
+
+==================  =======
+name                 hex
+==================  =======
+solarized@base03    #002b36 
+solarized@base02    #073642 
+solarized@base01    #586e75 
+solarized@base00    #657b83 
+solarized@base0     #839496 
+solarized@base1     #93a1a1 
+solarized@base2     #eee8d5 
+solarized@base3     #fdf6e3 
+solarized@yellow    #b58900 
+solarized@orange    #cb4b16 
+solarized@red       #dc322f 
+solarized@magenta   #d33682 
+solarized@violet    #6c71c4 
+solarized@blue      #268bd2 
+solarized@cyan      #2aa198 
+solarized@green     #859900 
+=================   =======
+
+Additionally, it defines these colors, whose values are
+dependent on options specified when the theme is loaded.
+
+solarized@accent
+  Accent color.
+
+solarized@rebase03-00
+  Dark colors if dark theme, light colors if light theme.
+
+solarized@rebase0-03
+  Light colors if dark theme, dark colors if light theme.
+
+