Document new batch comments methods

pengwynn · pengwynn · commit 96b1be1a2bf4 · 2012-12-04T12:15:43.000-06:00
diff --git a/content/v3/issues.md b/content/v3/issues.md
@@ -92,7 +92,7 @@ direction
 : `asc` or `desc`, default: `desc`.
 
 since
-: _Optional_ **string** of a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ
+: _Optional_ **String** of a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ
 
 ### Response
 
diff --git a/content/v3/issues/comments.md b/content/v3/issues/comments.md
@@ -23,6 +23,28 @@ You can read more about the use of mime types in the API
 <%= headers 200, :pagination => true %>
 <%= json(:issue_comment) { |h| [h] } %>
 
+## List comments in a repository
+
+    GET /repos/:owner/:repo/issues/comments
+
+By default, Issue Comments are ordered by ascending ID.
+
+### Parameters
+
+sort
+: _Optional_ **String** `created` or `updated`
+
+direction
+: _Optional_ **String** `asc` or `desc`. Ignored without `sort` parameter.
+
+since
+: _Optional_ **String** of a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ
+
+### Response
+
+<%= headers 200 %>
+<%= json(:pull_comment) { |h| [h] } %>
+
 ## Get a single comment
 
     GET /repos/:owner/:repo/issues/comments/:id
diff --git a/content/v3/pulls/comments.md b/content/v3/pulls/comments.md
@@ -25,6 +25,28 @@ types. You can read more about the use of mime types in the API
 <%= headers 200 %>
 <%= json(:pull_comment) { |h| [h] } %>
 
+## List comments in a repository
+
+    GET /repos/:owner/:repo/pulls/comments
+
+By default, Review Comments are ordered by ascending ID.
+
+### Parameters
+
+sort
+: _Optional_ **String** `created` or `updated`
+
+direction
+: _Optional_ **String** `asc` or `desc`. Ignored without `sort` parameter.
+
+since
+: _Optional_ **String** of a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ
+
+### Response
+
+<%= headers 200 %>
+<%= json(:pull_comment) { |h| [h] } %>
+
 ## Get a single comment
 
     GET /repos/:owner/:repo/pulls/comments/:number
@@ -123,3 +145,4 @@ more about the use of mime types in the API [here](/v3/media/).
     application/vnd.github.VERSION.text+json
     application/vnd.github.VERSION.html+json
     application/vnd.github.VERSION.full+json
+
