diff --git a/src/atom.coffee b/src/atom.coffee
index 8eca1abe4..925e9bd3a 100644
--- a/src/atom.coffee
+++ b/src/atom.coffee
@@ -39,7 +39,7 @@ class Atom extends Model
   # Public: Load or create the Atom environment in the given mode.
   #
   # - mode: Pass 'editor' or 'spec' depending on the kind of environment you
-  #         want to build.
+  #   want to build.
   #
   # Returns an Atom instance, fully initialized
   @loadOrCreate: (mode) ->
@@ -479,6 +479,8 @@ class Atom extends Model
     @getCurrentWindow().isFullScreen()
 
   # Public: Get the version of the Atom application.
+  #
+  # Returns the version text {String}.
   getVersion: ->
     @constructor.getVersion()
 
@@ -488,7 +490,7 @@ class Atom extends Model
 
   # Public: Get the directory path to Atom's configuration area.
   #
-  # Returns the absolute path to ~/.atom
+  # Returns the absolute path to `~/.atom`.
   getConfigDirPath: ->
     @constructor.getConfigDirPath()
 
diff --git a/src/editor.coffee b/src/editor.coffee
index 38dfb40f1..98dbd5d5a 100644
--- a/src/editor.coffee
+++ b/src/editor.coffee
@@ -563,7 +563,7 @@ class Editor extends Model
 
   bufferRowForScreenRow: (row) -> @displayBuffer.bufferRowForScreenRow(row)
 
-  # Public: Get the syntactic scopes for the most the given position in buffer
+  # Public: Get the syntactic scopes for the given position in buffer
   # coordinates.
   #
   # For example, if called with a position inside the parameter list of an