diff --git a/plugins/emoji/emoji.plugin.zsh b/plugins/emoji/emoji.plugin.zsh
index dbaf2bb9..a98d0b71 100644
--- a/plugins/emoji/emoji.plugin.zsh
+++ b/plugins/emoji/emoji.plugin.zsh
@@ -2,71 +2,7 @@
 #
 # Makes emoji support available within ZSH
 #
-# This plugin provides support for working with emoji characters in zsh using human-readable
-# identifiers. It provides global variables which map emoji names to the actual
-# characters, and some anmed groupings of emoji. It also provides associated functions 
-# for displaying them.
-#
-# Global variables:
-#   $emoji          - Maps emoji names to characters
-#   $emoji2         - Auxiliary and combining characters
-#   $emoji_flags    - Maps country names to flag characters (using region-indicators)
-#   $emoji_skintone - Skin tone modifiers (from Unicode 8.0)
-#   $emoji_groups   - Named groups of emoji. Keys are group names; values are whitespace-separated 
-#                       lists of character names
-#
-# Functions:
-#   random_emoji   - Prints a random emoji character
-#   display_emoji  - Displays emoji, along with their names
-#
-# The emoji names and codes are sourced from Unicode Technical Report #51, which provides
-# information on emoji support in Unicode. It can be found at http://www.unicode.org/reports/tr51/index.html.
-#
-# The group definitions are added by this OMZ plugin. They are not based on external definitions.
-#
-# The emoji in the main $emoji map are standalone character sequences which can all be output on their
-# own, without worrying about combining effects. The values may actually be multi-code-point sequences, 
-# instead of a single code point, and may include combining characters in those sequences. But they're
-# arranged so their effects do not extend beyond that sequence.
-#
-# Usage and Examples:
-#
-# To output a specific emoji, use:
-#    $> echo $emoji[<name>]
-# E.g.: 
-#    $> echo $emoji[mouse_face]
-#
-# To output a random emoji, use:
-#    $> random_emoji
-# To output a random emoji from a particular group, use:
-#    $> random_emoji <group>
-# E.g.:
-#    $> random_emoji fruits
-#    $> random_emoji animals
-#    $> random_emoji vehicles
-#    $> random_emoji faces
-# The valid group names can be found with `echo ${(k)emoji_groups}`
-#
-# To list all available emoji with their names, use:
-#    $> display_emoji
-#    $> display_emoji fruits
-#    $> display_emoji animals
-#    $> display_emoji vehicles
-#    $> display_emoji faces
-#
-# To use emoji in a prompt:
-#    PROMPT="$emoji[penguin]  > ""
-#    PROMPT='$(random_emoji fruits)  > '
-#    surfer=$emoji[surfer]
-#    PROMPT="$surfer  > "
-#
-#
-# TODO: Move doco to a README
-# TODO: Factor out parsing from generation in update_emoji.pl
-# TODO: Incorporate CLDR data for ordering and groupings
-# TODO: Short :bracket: style names (from gemoji)
-# TODO: Country codes for flags
-# TODO: ZWJ combining function?
+# See the README for documentation.
 
 _omz_emoji_plugin_dir="${0:h}"