diff --git a/src/decoration.coffee b/src/decoration.coffee
index cd5035e5f..7216aee18 100644
--- a/src/decoration.coffee
+++ b/src/decoration.coffee
@@ -61,13 +61,16 @@ class Decoration
 
   # Essential: When the {Decoration} is updated via {Decoration::update}.
   #
-  # * `event` {Object}
-  #   * `oldProperties` {Object} the old parameters the decoration used to have
-  #   * `newProperties` {Object} the new parameters the decoration now has
+  # * `callback` {Function}
+  #   * `event` {Object}
+  #     * `oldProperties` {Object} the old parameters the decoration used to have
+  #     * `newProperties` {Object} the new parameters the decoration now has
   onDidChangeProperties: (callback) ->
     @emitter.on 'did-change-properties', callback
 
   # Essential: Invoke the given callback when the {Decoration} is destroyed
+  #
+  # * `callback` {Function}
   onDidDestroy: (callback) ->
     @emitter.on 'did-destroy', callback