diff --git a/modules/macports/README.md b/modules/macports/README.md
new file mode 100644
index 00000000..7a9681ae
--- /dev/null
+++ b/modules/macports/README.md
@@ -0,0 +1,26 @@
+Macports
+========
+
+Defines MacPorts aliases and adds MacPorts directories to path variables.
+
+Aliases
+-------
+
+  - `portc` cleans the files used to build ports.
+  - `porti` installs a port.
+  - `ports` searches for a port.
+  - `portu` upgrades a port.
+  - `portU` upgrades MacPorts, the ports collection, and outdated ports.
+  - `portx` uninstalls a port.
+  - `portX` uninstalls inactive ports.
+
+Authors
+-------
+
+*The authors of this module should be contacted via the [issue tracker][1].*
+
+  - [Matt Cable](https://github.com/curiousstranger)
+  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+
+[1]: https://github.com/sorin-ionescu/oh-my-zsh/issues
+