New README in markdown.

README.md

@@ -0,0 +1,71 @@
+"OH MY ZSHELL!"
+===============
+
+**NOTE**: This documentation isn't finished and this project is
+currently under rapid development. Be cautious, information here may
+not be up to date.
+
+**NOTE**: This fork is specifically for Archlinux and has been patched
+for a system-wide install; Don't attempt to install to ~/.oh-my-zsh!
+This project had radically diverged away from its source. While
+plugins should remain compatible, there is much which has changed.
+
+Setup
+-----
+
+`oh-my-zsh` should work with any recent release of [zsh][], the
+minimum recommended version is 4.3.9.
+
+A package can be found in Archlinux's [AUR][oh-my-zsh-git]. We
+recommend using [cower] to install it:
+
+```
+cower -dd oh-my-zsh-git
+```
+
+  [zsh]: http://www.zsh.org/
+  [oh-my-zsh-git]: https://aur.archlinux.org/packages.php?ID=54375
+  [cower]: https://github.com/falconindy/cower
+
+The user must have zsh set as their shell.
+
+```
+# chsh -s /bin/zsh <USERNAME>
+```
+
+The following needs to be added to the start of the user's `~/.zshrc`
+file to activate oh-my-zshell goodness.
+
+```
+ZSH_THEME="arch-blue"
+plugins=(archlinux sprunge git)
+load_oh_my_zshell
+```
+
+A skeleton template can be found in
+`/usr/share/oh-my-zsh/templates/user.zsh-template`
+
+Customization
+=============
+
+- To enable more the plugins, customize the plugins array in your
+  `~/.zshrc`
+- To change themes, change the @ZSH_THEME@ environment variable in
+  `~/.zshrc`.
+
+If you want to override any of the default behaviour, just add a new
+file (ending in `.zsh`) into the `~/.omz/` directory. If you have many
+functions which go good together you can put them as a *.plugin.zsh
+file in the `~/.omz/plugins/` directory.
+
+If you would like to override the functionality of a plugin
+distributed with oh-my-zsh, create a plugin of the same name in the
+`~/.omz/plugins/` directory and it will be loaded instead of the one
+provided one.
+
+Resources
+---------
+
+The [refcard][] is pretty tasty for tips.
+
+  [refcard]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf