diff --git a/modules/python/README.md b/modules/python/README.md
new file mode 100644
index 00000000..2ef025eb
--- /dev/null
+++ b/modules/python/README.md
@@ -0,0 +1,26 @@
+Python
+======
+
+Enables local Python package installation (see [PEP 370][1]) and
+[_virtualenvwrapper_][2], if installed.
+
+This module will prepend the per user site packages directory as defined in [PEP
+370][1] to `$path` and `$manpath` so that you can run Python scripts and read
+man pages installed into the per user site.
+
+It also sources the [_virtualenvwrapper_][2] initialization script, if
+[_virtualenvwrapper_][2] is installed.  [_virtualenvwrapper_][2] is a frontend
+to [_virtualenv_][3] which provides convenient shell functions to create, switch
+and manage virtualenvs.
+
+Authors
+-------
+
+*The authors of this module should be contacted via the github bug tracker.*
+
+ - [Sorin Ionescu](/sorin-ionescu)
+ - [Sebastian Wiesner](/lunaryorn)
+
+[1]: http://www.python.org/dev/peps/pep-0370/
+[2]: http://www.doughellmann.com/projects/virtualenvwrapper/
+[3]: http://pypi.python.org/pypi/virtualenv
diff --git a/modules/python/init.zsh b/modules/python/init.zsh
index 0c181fdb..17120174 100644
--- a/modules/python/init.zsh
+++ b/modules/python/init.zsh
@@ -1,8 +1,12 @@
 #
-# Enables local Python package installation.
+# Enables local Python package installation and virtualenvwrapper if installed.
+#
+# virtualenvwrapper is a utility to easily create, switch and manage Python
+# virtualenvs. See http://www.doughellmann.com/projects/virtualenvwrapper/
 #
 # Authors:
 #   Sorin Ionescu <sorin.ionescu@gmail.com>
+#   Sebastian Wiesner <lunaryorn@googlemail.com>
 #
 
 # Prepend PEP 370 per user site packages directory, which defaults to
@@ -16,3 +20,7 @@ else
   manpath=($HOME/.local/{,share/}man(N) $manpath)
 fi
 
+# source virtualenvwrapper if available
+if (( $+commands[virtualenvwrapper.sh] )); then
+    source virtualenvwrapper.sh
+fi
diff --git a/modules/virtualenvwrapper/README.md b/modules/virtualenvwrapper/README.md
deleted file mode 100644
index 27ad741c..00000000
--- a/modules/virtualenvwrapper/README.md
+++ /dev/null
@@ -1,20 +0,0 @@
-virtualenvwrapper
-=================
-
-Enables [virtualenvwrapper][venvwrapper] if installed.
-
-[virtualenvwrapper][venvwrapper] is a frontend to [virtualenv][venv] which
-provides convenient shell functions to create, switch and manage virtualenvs.
-
-This module will source the virtualenvwrapper initialization script, if
-[virtualenvwrapper][venvwrapper] is installed.
-
-Authors
--------
-
-*The authors of this module should be contacted via the github bug tracker.*
-
- - [Sebastian Wiesner](https://github.com/lunaryorn)
-
-[venvwrapper]: http://www.doughellmann.com/projects/virtualenvwrapper/
-[venv]: http://pypi.python.org/pypi/virtualenv
diff --git a/modules/virtualenvwrapper/init.zsh b/modules/virtualenvwrapper/init.zsh
deleted file mode 100644
index e45f8017..00000000
--- a/modules/virtualenvwrapper/init.zsh
+++ /dev/null
@@ -1,13 +0,0 @@
-#
-# Enables virtualenvwrapper if available.
-#
-# virtualenvwrapper is a utility to easily create, switch and manage Python
-# virtualenvs. See http://www.doughellmann.com/projects/virtualenvwrapper/
-#
-# Authors:
-#   Sebastian Wiesner <lunaryorn@googlemail.com>
-#
-
-if (( $+commands[virtualenvwrapper.sh] )); then
-    source virtualenvwrapper.sh
-fi