diff --git a/src/workspace.coffee b/src/workspace.coffee
index d64898169..bde2a62d3 100644
--- a/src/workspace.coffee
+++ b/src/workspace.coffee
@@ -589,10 +589,11 @@ class Workspace extends Model
 
   # Public: Register an opener for a uri.
   #
-  # Atom loops through opener functions until one returns a value for a given uri.
+  # When a URI is opened via {Workspace::open}, Atom loops through its registered
+  # opener functions until one returns a value for the given uri.
   # Openers are expected to return an object that inherits from HTMLElement or
   # a model which has an associated view in the {ViewRegistry}.
-  # A {TextEditor} will be used if no openers return a value.
+  # A {TextEditor} will be used if no opener returns a value.
   #
   # ## Examples
   #