Merge pull request github#985 from github/update-1454429507

hubot · hubot · commit d7f5104f8670 · 2016-02-02T10:11:51.000-06:00
diff --git a/content/v3/gists.md b/content/v3/gists.md
@@ -22,9 +22,9 @@ If you need the full contents of the file, you can make a `GET` request to the U
 
 In addition to a specific file's contents being truncated, the entire files list may be trucated if the total number exceeds 300 files. If the top level `truncated` key is `true`, only the first 300 files have been returned in the files list. If you need to fetch all of the gist's files, you'll need to clone the gist via the URL provided by `git_pull_url`.
 
-## List gists
+## List a user's gists
 
-List a user's gists:
+List public gists for the specified user:
 
     GET /users/:username/gists
 
@@ -33,10 +33,38 @@ return all public gists:
 
     GET /gists
 
-List all public gists:
+### Parameters
+
+Name | Type | Description
+-----|------|--------------
+`since`|`string` | A timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`. Only gists updated at or after this time are returned.
+
+### Response
+
+<%= headers 200, :pagination => default_pagination_rels %>
+<%= json(:gist) { |h| [h] } %>
+
+## List all public gists
+
+List all public gists sorted by most recently updated to least recently updated.
+
+Note: With pagination, you can fetch up to 200 [pages](/v3/#pagination).
 
     GET /gists/public
 
+### Parameters
+
+Name | Type | Description
+-----|------|--------------
+`since`|`string` | A timestamp in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`. Only gists updated at or after this time are returned.
+
+### Response
+
+<%= headers 200, :pagination => default_pagination_rels %>
+<%= json(:gist) { |h| [h] } %>
+
+## List starred gists
+
 List the authenticated user's starred gists:
 
     GET /gists/starred
