diff --git a/modules/terminal/README.md b/modules/terminal/README.md
new file mode 100644
index 0000000..136b82f
--- /dev/null
+++ b/modules/terminal/README.md
@@ -0,0 +1,25 @@
+Terminal
+========
+
+Sets terminal window and tab titles.
+
+Settings
+--------
+
+### Auto-Title
+
+To auto set the terminal window and tab titles with the current command or
+directory, add the following to *zshrc*:
+
+    zstyle ':omz:module:terminal' auto-title 'yes'
+
+Authors
+-------
+
+*The authors of this module should be contacted via the [issue tracker][1].*
+
+  - [James Cox](https://github.com/imajes)
+  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+
+[1]: https://github.com/sorin-ionescu/oh-my-zsh/issues
+
diff --git a/modules/terminal/init.zsh b/modules/terminal/init.zsh
index a1a1623..d0bab0b 100644
--- a/modules/terminal/init.zsh
+++ b/modules/terminal/init.zsh
@@ -5,12 +5,6 @@
 #   James Cox <james@imaj.es>
 #   Sorin Ionescu <sorin.ionescu@gmail.com>
 #
-# Usage:
-#   To auto set the terminal window and tab titles with the current command or
-#   directory, add the following to zshrc:
-#
-#     zstyle ':omz:module:terminal' auto-title 'yes'
-#
 
 # Dumb terminals lack support.
 if [[ "$TERM" == 'dumb' ]]; then