diff --git a/modules/yum/README.md b/modules/yum/README.md
new file mode 100644
index 00000000..efdc27b8
--- /dev/null
+++ b/modules/yum/README.md
@@ -0,0 +1,29 @@
+yum
+===
+
+Defines [`yum`][1] aliases.
+
+Aliases
+-------
+
+- `ys` searches packages.
+- `yp` shows package info.
+- `yl` lists packages.
+- `yli` lists installed packages.
+- `yu` updates installed packages.
+- `yi` installs packages.
+- `yr` removes packages.
+- `yrl` removes packages, including any unused dependencies (with
+  `yum-plugin-remove-with-leaves`).
+- `yc` cleans the cache.
+
+Authors
+-------
+
+*The authors of this module should be contacted via the [issue tracker][2].*
+
+  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+
+[1]: http://yum.baseurl.org/
+[2]: https://github.com/sorin-ionescu/oh-my-zsh/issues
+