diff --git a/powerlevel9k.zsh-theme b/powerlevel9k.zsh-theme
index b13b2159..8a3d97b9 100644
--- a/powerlevel9k.zsh-theme
+++ b/powerlevel9k.zsh-theme
@@ -1,5 +1,5 @@
 # vim:ft=zsh ts=2 sw=2 sts=2
-#
+################################################################
 # powerlevel9k Theme
 # https://github.com/bhilburn/powerlevel9k
 #
@@ -11,10 +11,34 @@
 #
 # In order for this theme to render correctly, you will need a Powerline-patched font:
 # https://github.com/Lokaltog/powerline-fonts
-#
+################################################################
 
-### Segment drawing
-# A few utility functions to make it easy and re-usable to draw segmented prompts
+################################################################
+# Please see the README file located in the source repository for full docs.
+# What follows is a brief list of the settings variables used by this theme.
+# You should define these variables in your `~/.zshrc`.
+#
+# Customize which segments appear in which prompts (below is also the default):
+#   POWERLEVEL9K_LEFT_PROMPT_ELEMENTS=(context dir rbenv vcs)
+#   POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS=(status history time)
+#
+# Set your Amazon Web Services profile for the `aws` segment:
+#   export AWS_DEFAULT_PROFILE=<profile_name>
+#
+# Set your username for the `context` segment:
+#   export DEFAULT_USER=<your username>
+#
+# Show the hash/changeset string in the `vcs` segment:
+#   POWERLEVEL9K_SHOW_CHANGESET=true
+# Set the length of the hash/changeset if enabled in the `vcs` segment:
+#   POWERLEVEL9K_CHANGESET_HASH_LENGTH=6
+#
+# Make powerlevel9k a double-lined prompt:
+#   POWERLEVEL9K_PROMPT_ON_NEWLINE=true
+#
+# Set the colorscheme:
+#   POWERLEVEL9K_COLOR_SCHEME='light'
+################################################################
 
 # The `CURRENT_BG` variable is used to remember what the last BG color used was
 # when building the left-hand prompt. Because the RPROMPT is created from