chore: update .gitignore for gh-pages artifacts

* tweak documentation comments for new comment-related Gist functions

Author: clayreimann

.gitignore

@@ -1,3 +1,5 @@
+.sass-cache/
+_site/
 docs/
 dist/
 coverage/

lib/Gist.js

@@ -108,10 +108,8 @@ class Gist extends Requestable {
       return this._request204or404(`/gists/${this.__id}/star`, null, cb);
    }
 
-
-
    /**
-    * List the comments on a gist
+    * List the gist's comments
     * @see https://developer.github.com/v3/gists/comments/#list-comments-on-a-gist
     * @param {Requestable.callback} [cb] - will receive the array of comments
     * @return {Promise} - the promise for the http request
@@ -121,7 +119,7 @@ class Gist extends Requestable {
    }
 
    /**
-    * Fetch a comment of the gist
+    * Fetch one of the gist's comments
     * @see https://developer.github.com/v3/gists/comments/#get-a-single-comment
     * @param {number} comment - the id of the comment
     * @param {Requestable.callback} [cb] - will receive the comment
@@ -132,7 +130,7 @@ class Gist extends Requestable {
    }
 
    /**
-    * Create Comment to a gist.
+    * Comment on a gist
     * @see https://developer.github.com/v3/gists/comments/#create-a-comment
     * @param {string} comment - the comment to add
     * @param {Requestable.callback} [cb] - the function that receives the API result
@@ -143,19 +141,19 @@ class Gist extends Requestable {
    }
 
    /**
-    * Edit a Gist Comment
+    * Edit a comment on the gist
     * @see https://developer.github.com/v3/gists/comments/#edit-a-comment
     * @param {number} comment - the id of the comment
     * @param {string} body - the new comment
-    * @param {Requestable.callback} [cb] - will receive the modified issue
+    * @param {Requestable.callback} [cb] - will receive the modified comment
     * @return {Promise} - the promise for the http request
     */
    editComment(comment, body, cb) {
       return this._request('PATCH', `/gists/${this.__id}/comments/${comment}`, {body: body}, cb);
    }
 
    /**
-    * Delete a comment of a gist.
+    * Delete a comment on the gist.
     * @see https://developer.github.com/v3/gists/comments/#delete-a-comment
     * @param {number} comment - the id of the comment
     * @param {Requestable.callback} [cb] - will receive true if the request succeeds