 #     you should set this to "yourcompany" (without the quotes).
 #
 # Commands:
-#   hubot remember my harvest account <email> with password <password> - Saves your Harvest credentials to allow Hubot to track time for you
+#   hubot remember my harvest account <email> with password <password> - Saves your Harvest credentials
+#                                                                        to allow Hubot to track time for you
 #   hubot forget my harvest account - Deletes your account credentials from Hubot's memory
-#   hubot start harvest at <project>: notes - TODO
+#   hubot start harvest at <project>/<task>: <notes> - Start a timer for a task at a project
+#                                                      (both of which may be abbreviated, Hubot
+#                                                      will ask you if your input is ambigious).
+#                                                      An existing timer (if any) will be stopped.
 #   hubot finish harvest at <project> - TODO
 #   hubot daily harvest [of <user>] - Hubot responds with your/a specific user's entries for today
+#
+# Notes:
+# All commands and command arguments are case-insenstive. If you work
+# on a project "FooBar", hubot will unterstand "foobar" as well. This
+# is also true for abbreviations, so if you don't have similary named
+# projects, "foob" will do as expected.
 # 
 # Author:
 #   Quintus

      "Accept": "application/json"
    .auth(@email, @password)
    return req

    this.request(msg).path("daily").get() (err, res, body) ->
      callback res.statusCode, JSON.parse(body)

  # Issues /daily/add to the Harvest API to add a new timer
  # starting from now.
  start: (msg, target_project, target_task, notes, callback) ->
    this.find_project_and_task msg, target_project, target_task, (project, task) =>
      # OK, task and project found. Start the tracker.
      data =
        notes: notes
        project_id: project.id
        task_id: task.id
      this.request(msg).path("/daily/add").post(JSON.stringify(data)) (err, res, body) ->
        callback res.statusCode, JSON.parse(body)

  # (internal method)
  # Assembles the basic parts of a request to the Harvest
  # API, i.e. the Content-Type/Accept and authorization
