diff --git a/src/atom.coffee b/src/atom.coffee
index 04d998ff7..29c77d864 100644
--- a/src/atom.coffee
+++ b/src/atom.coffee
@@ -344,10 +344,14 @@ class Atom
     app.getVersion()
 
   # Public: Get the directory path to Atom's configuration area.
+  #
+  # Returns the absolute path to ~/.atom
   getConfigDirPath: ->
     @configDirPath ?= fs.absolute('~/.atom')
 
   # Public: Get the directory path to Atom's storage area.
+  #
+  # Returns the absoluste path to ~/.atom/storage
   getStorageDirPath: ->
     @storageDirPath ?= path.join(@getConfigDirPath(), 'storage')