Add documentation files

docs/configuration.rst

@@ -0,0 +1,4 @@
+Configuration
+=============
+
+.. include:: configuration/vim.rst

docs/configuration/vim.rst

@@ -0,0 +1,2 @@
+Vim configuration
+-----------------

docs/index.rst

@@ -5,6 +5,10 @@ Powerline
    :maxdepth: 3
    :glob:
 
+   introduction
+   installation
+   configuration
+
 Indices and tables
 ==================
 

docs/installation.rst

@@ -0,0 +1,10 @@
+Installation
+============
+
+Powerline is intended to be installed as a system-wide Python package that 
+can be easily included in other projects.
+
+.. note:: This project is currently unavailable on the PyPI due to a naming 
+   conflict with an unrelated project.
+
+.. include:: installation/vim.rst

docs/installation/vim.rst

@@ -0,0 +1,20 @@
+Vim installation
+----------------
+
+As a system-wide Python package
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Add the following line to your ``vimrc``::
+
+    python import plugin.vim.load_vim_plugin
+
+Outside Python's search path
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+This requires you to source the plugin file with an absolute path to the 
+plugin location.
+
+Add the following line to your ``vimrc``, where ``{path}`` is the path to 
+the main Powerline project folder::
+
+    source {path}/plugin/vim/powerline.vim

docs/introduction.rst

@@ -0,0 +1,2 @@
+Introduction
+============