diff --git a/src/text-editor-element.coffee b/src/text-editor-element.coffee
index 6722f51df..380417163 100644
--- a/src/text-editor-element.coffee
+++ b/src/text-editor-element.coffee
@@ -347,6 +347,12 @@ class TextEditorElement extends HTMLElement
   getHeight: ->
     @offsetHeight
 
+  # Experimental: Invalidate the passed block {Decoration} dimensions, forcing
+  # them to be recalculated and the surrounding content to be adjusted on the
+  # next animation frame.
+  #
+  # * {blockDecoration} A {Decoration} representing the block decoration you
+  # want to update the dimensions of.
   invalidateBlockDecorationDimensions: ->
     @component.invalidateBlockDecorationDimensions(arguments...)