diff --git a/src/project.coffee b/src/project.coffee
index f2ace97e2..4f5dc37bc 100644
--- a/src/project.coffee
+++ b/src/project.coffee
@@ -278,6 +278,12 @@ class Project extends Model
   Section: Environment
   ###
 
+  # Public: Retrieves a normalized copy of the environment.
+  #
+  # On OS X, the `PATH` can be different depending on whether Atom is launched
+  # from the Dock, Spotlight or the terminal. This detects how Atom was started
+  # and corrects the `PATH` environment variable before returning a copy of the
+  # environment.
   getEnv: ->
     unless @env?
       @env = _.clone(process.env)