       # --------
       # Takes an object of optional paramaters:
       #
-      # - path: Only commits containing this file path will be returned
-      # - author: GitHub login, name, or email by which to filter by commit author
-      # - since: ISO 8601 date - only commits after this date will be returned
-      # - until: ISO 8601 date - only commits before this date will be returned
+      # - `path`: Only commits containing this file path will be returned
+      # - `author`: GitHub login, name, or email by which to filter by commit author
+      # - `since`: ISO 8601 date - only commits after this date will be returned
+      # - `until`: ISO 8601 date - only commits before this date will be returned
       getCommits: (options) ->
         @git.getCommits(options)
 
 
+    # Gist API
+    # -------
     class Gist
       constructor: (@options) ->
         id = @options.id

      getBranches: -> @git.getBranches()


      getBranch: (branchName) ->
        getRef = =>
          deferred = new jQuery.Deferred()


      # Create the gist
      # --------
      #
      #     {
      #        "description": "the description for this gist",
      #        "public": true,
      #        "files": {
      #          "file1.txt": {
      #            "content": "String file contents"
      #          }
      #        }
      #     }
      create: (options) ->
        _request 'POST', "/gists", options

