diff --git a/modules/macports/README.md b/modules/macports/README.md
new file mode 100644
index 00000000..aa13716e
--- /dev/null
+++ b/modules/macports/README.md
@@ -0,0 +1,27 @@
+Macports
+========
+
+Defines aliases and paths for macports on OSX.
+
+Aliases
+-------
+
+### General
+
+  - `pc` clean port tree
+  - `pi` install a port
+  - `psu` selfupdate ports
+  - `puni` uninstall inactive ports
+  - `puo` upgrade outdated ports
+  - `pup` selfupdate and upgrade outdated ports
+
+Authors
+-------
+
+*The authors of this module should be contacted via the [issue tracker][1].*
+
+  - [Robby Russell](https://github.com/robbyrussell)
+  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+
+[1]: https://github.com/sorin-ionescu/oh-my-zsh/issues
+