     # Now we're ready - display the suggestions
     return suggestions
 
-  ###
-   * Gets called when a suggestion has been confirmed by the user. Return true
-   * to replace the word with the suggestion. Return false if you want to handle
-   * the behavior yourself.
-   * @param  {Suggestion} suggestion
-   * @return {Boolean}
-   * @public
-  ###
+  # Public: Gets called when a suggestion has been confirmed by the user. Return
+  # true to replace the word with the suggestion. Return false if you want to
+  # handle the behavior yourself.
+  #
+  # item - The confirmed {Suggestion}
+  #
+  # Returns a {Boolean} that specifies whether autocomplete+ should replace
+  # the word with the suggestion.
   confirm: (item) ->
     return true
 
-  # ! Private Methods
-
-  ###
-   * Gets called when the user saves the document. Rebuilds the word list
-   * @private
-  ###
+  # Private: Gets called when the user saves the document. Rebuilds the word
+  # list.
   onSaved: =>
     @buildWordList()
 
-  ###
-   * Gets called when the buffer's text has been changed. Checks if the user
-   * has potentially finished a word and adds the new word to the word list.
-   * @param  {Event} e
-   * @private
-  ###
+  # Private: Gets called when the buffer's text has been changed. Checks if the
+  # user has potentially finished a word and adds the new word to the word list.
+  #
+  # e - The change {Event}
   onChanged: (e) =>
     if e.newText in ["\n", " "]
       newLine = e.newText is "\n"
       @addLastWordToList newLine
 
-  ###
-   * Adds the last typed word to the wordList
-   * @param {Boolean} newLine
-   * @private
-  ###
+  # Private: Adds the last typed word to the wordList
+  #
+  # newLine - {Boolean} Has a new line been typed?
   addLastWordToList: (newLine) ->
     lastWord = @lastTypedWord newLine
     return unless lastWord


    return lastWord

  ###
   * Generates the word list from the editor buffer(s)
   * @private
  ###
  buildWordList: ->
    # Abuse the Hash as a Set
    wordList = []

    p.stop()
    return results

  # Private: Finds autocompletions in the current syntax scope (e.g. css values)
  #
  # Returns an {Array} of strings
  getCompletionsForCursorScope: ->
    cursorScope = @editor.scopesForBufferPosition @editor.getCursorBufferPosition()
    completions = atom.syntax.propertiesForScope cursorScope, "editor.completions"
