{"action":"created","comment":{"url":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/comments/62655545","id":62655545,"diff_hunk":"@@ -52,6 +52,29 @@ List all domains for the account 1010 that have name matching \"example\":\n           -H 'Accept: application/json' \\\n           https://api.dnsimple.com/v2/1010/domains?name_like=example\n \n+### Sorting\n+\n+Sort records with the `sorting` param by specifing the field and the sorting policy: `asc` for ascending and `desc` for descending.\n+Multiple fields are allowed and MUST be comma separated.\n+\n+Name | Description\n+-----|------------\n+`:id` | Sort domains by ID\n+`:name` | Sort domains by name\n+`:expires_on` | Sort domains by expiration date\n+`:created_at` | Sort domains by creation timestamp\n+`:updated_at` | Sort domains by last update timestamp\n+\n+The default sorting policy is by ascending `:name`.","path":"content/v2/domains.markdown","position":17,"original_position":17,"commit_id":"784ed7d05a96926ff6d599e5fdce41ac973efc5a","original_commit_id":"784ed7d05a96926ff6d599e5fdce41ac973efc5a","user":{"login":"jacegu","id":381143,"avatar_url":"https://avatars.githubusercontent.com/u/381143?v=3","gravatar_id":"","url":"https://api.github.com/users/jacegu","html_url":"https://github.com/jacegu","followers_url":"https://api.github.com/users/jacegu/followers","following_url":"https://api.github.com/users/jacegu/following{/other_user}","gists_url":"https://api.github.com/users/jacegu/gists{/gist_id}","starred_url":"https://api.github.com/users/jacegu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jacegu/subscriptions","organizations_url":"https://api.github.com/users/jacegu/orgs","repos_url":"https://api.github.com/users/jacegu/repos","events_url":"https://api.github.com/users/jacegu/events{/privacy}","received_events_url":"https://api.github.com/users/jacegu/received_events","type":"User","site_admin":false},"body":"We should probably add something like _\"which is the equivalent to sorting them alphabetically\"_. (Even though these docs are for technical people _by ascending `name`_ sounds way more confusing by alphabetically).","created_at":"2016-05-10T11:35:48Z","updated_at":"2016-05-10T11:35:48Z","html_url":"https://github.com/aetrion/dnsimple-developer/pull/72#discussion_r62655545","pull_request_url":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/72","_links":{"self":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/comments/62655545"},"html":{"href":"https://github.com/aetrion/dnsimple-developer/pull/72#discussion_r62655545"},"pull_request":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/72"}}},"pull_request":{"url":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/72","id":69484969,"html_url":"https://github.com/aetrion/dnsimple-developer/pull/72","diff_url":"https://github.com/aetrion/dnsimple-developer/pull/72.diff","patch_url":"https://github.com/aetrion/dnsimple-developer/pull/72.patch","issue_url":"https://api.github.com/repos/aetrion/dnsimple-developer/issues/72","number":72,"state":"open","locked":false,"title":"API v2: Document sorting (part 1)","user":{"login":"jodosha","id":5089,"avatar_url":"https://avatars.githubusercontent.com/u/5089?v=3","gravatar_id":"","url":"https://api.github.com/users/jodosha","html_url":"https://github.com/jodosha","followers_url":"https://api.github.com/users/jodosha/followers","following_url":"https://api.github.com/users/jodosha/following{/other_user}","gists_url":"https://api.github.com/users/jodosha/gists{/gist_id}","starred_url":"https://api.github.com/users/jodosha/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jodosha/subscriptions","organizations_url":"https://api.github.com/users/jodosha/orgs","repos_url":"https://api.github.com/users/jodosha/repos","events_url":"https://api.github.com/users/jodosha/events{/privacy}","received_events_url":"https://api.github.com/users/jodosha/received_events","type":"User","site_admin":false},"body":"/cc @weppos @jacegu ","created_at":"2016-05-10T10:47:05Z","updated_at":"2016-05-10T11:35:48Z","closed_at":null,"merged_at":null,"merge_commit_sha":"3b0fe6cc4f84781cad74cc41759a316e93306eaf","assignee":{"login":"jodosha","id":5089,"avatar_url":"https://avatars.githubusercontent.com/u/5089?v=3","gravatar_id":"","url":"https://api.github.com/users/jodosha","html_url":"https://github.com/jodosha","followers_url":"https://api.github.com/users/jodosha/followers","following_url":"https://api.github.com/users/jodosha/following{/other_user}","gists_url":"https://api.github.com/users/jodosha/gists{/gist_id}","starred_url":"https://api.github.com/users/jodosha/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jodosha/subscriptions","organizations_url":"https://api.github.com/users/jodosha/orgs","repos_url":"https://api.github.com/users/jodosha/repos","events_url":"https://api.github.com/users/jodosha/events{/privacy}","received_events_url":"https://api.github.com/users/jodosha/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/72/commits","review_comments_url":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/72/comments","review_comment_url":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/comments{/number}","comments_url":"https://api.github.com/repos/aetrion/dnsimple-developer/issues/72/comments","statuses_url":"https://api.github.com/repos/aetrion/dnsimple-developer/statuses/784ed7d05a96926ff6d599e5fdce41ac973efc5a","head":{"label":"aetrion:api-v2-sorting-part-1","ref":"api-v2-sorting-part-1","sha":"784ed7d05a96926ff6d599e5fdce41ac973efc5a","user":{"login":"aetrion","id":323774,"avatar_url":"https://avatars.githubusercontent.com/u/323774?v=3","gravatar_id":"","url":"https://api.github.com/users/aetrion","html_url":"https://github.com/aetrion","followers_url":"https://api.github.com/users/aetrion/followers","following_url":"https://api.github.com/users/aetrion/following{/other_user}","gists_url":"https://api.github.com/users/aetrion/gists{/gist_id}","starred_url":"https://api.github.com/users/aetrion/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/aetrion/subscriptions","organizations_url":"https://api.github.com/users/aetrion/orgs","repos_url":"https://api.github.com/users/aetrion/repos","events_url":"https://api.github.com/users/aetrion/events{/privacy}","received_events_url":"https://api.github.com/users/aetrion/received_events","type":"Organization","site_admin":false},"repo":{"id":5965968,"name":"dnsimple-developer","full_name":"aetrion/dnsimple-developer","owner":{"login":"aetrion","id":323774,"avatar_url":"https://avatars.githubusercontent.com/u/323774?v=3","gravatar_id":"","url":"https://api.github.com/users/aetrion","html_url":"https://github.com/aetrion","followers_url":"https://api.github.com/users/aetrion/followers","following_url":"https://api.github.com/users/aetrion/following{/other_user}","gists_url":"https://api.github.com/users/aetrion/gists{/gist_id}","starred_url":"https://api.github.com/users/aetrion/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/aetrion/subscriptions","organizations_url":"https://api.github.com/users/aetrion/orgs","repos_url":"https://api.github.com/users/aetrion/repos","events_url":"https://api.github.com/users/aetrion/events{/privacy}","received_events_url":"https://api.github.com/users/aetrion/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/aetrion/dnsimple-developer","description":"The DNSimple API Documentation.","fork":false,"url":"https://api.github.com/repos/aetrion/dnsimple-developer","forks_url":"https://api.github.com/repos/aetrion/dnsimple-developer/forks","keys_url":"https://api.github.com/repos/aetrion/dnsimple-developer/keys{/key_id}","collaborators_url":"https://api.github.com/repos/aetrion/dnsimple-developer/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/aetrion/dnsimple-developer/teams","hooks_url":"https://api.github.com/repos/aetrion/dnsimple-developer/hooks","issue_events_url":"https://api.github.com/repos/aetrion/dnsimple-developer/issues/events{/number}","events_url":"https://api.github.com/repos/aetrion/dnsimple-developer/events","assignees_url":"https://api.github.com/repos/aetrion/dnsimple-developer/assignees{/user}","branches_url":"https://api.github.com/repos/aetrion/dnsimple-developer/branches{/branch}","tags_url":"https://api.github.com/repos/aetrion/dnsimple-developer/tags","blobs_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/refs{/sha}","trees_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/trees{/sha}","statuses_url":"https://api.github.com/repos/aetrion/dnsimple-developer/statuses/{sha}","languages_url":"https://api.github.com/repos/aetrion/dnsimple-developer/languages","stargazers_url":"https://api.github.com/repos/aetrion/dnsimple-developer/stargazers","contributors_url":"https://api.github.com/repos/aetrion/dnsimple-developer/contributors","subscribers_url":"https://api.github.com/repos/aetrion/dnsimple-developer/subscribers","subscription_url":"https://api.github.com/repos/aetrion/dnsimple-developer/subscription","commits_url":"https://api.github.com/repos/aetrion/dnsimple-developer/commits{/sha}","git_commits_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/commits{/sha}","comments_url":"https://api.github.com/repos/aetrion/dnsimple-developer/comments{/number}","issue_comment_url":"https://api.github.com/repos/aetrion/dnsimple-developer/issues/comments{/number}","contents_url":"https://api.github.com/repos/aetrion/dnsimple-developer/contents/{+path}","compare_url":"https://api.github.com/repos/aetrion/dnsimple-developer/compare/{base}...{head}","merges_url":"https://api.github.com/repos/aetrion/dnsimple-developer/merges","archive_url":"https://api.github.com/repos/aetrion/dnsimple-developer/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/aetrion/dnsimple-developer/downloads","issues_url":"https://api.github.com/repos/aetrion/dnsimple-developer/issues{/number}","pulls_url":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls{/number}","milestones_url":"https://api.github.com/repos/aetrion/dnsimple-developer/milestones{/number}","notifications_url":"https://api.github.com/repos/aetrion/dnsimple-developer/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/aetrion/dnsimple-developer/labels{/name}","releases_url":"https://api.github.com/repos/aetrion/dnsimple-developer/releases{/id}","deployments_url":"https://api.github.com/repos/aetrion/dnsimple-developer/deployments","created_at":"2012-09-26T13:13:01Z","updated_at":"2016-01-16T16:01:32Z","pushed_at":"2016-05-10T10:47:05Z","git_url":"git://github.com/aetrion/dnsimple-developer.git","ssh_url":"git@github.com:aetrion/dnsimple-developer.git","clone_url":"https://github.com/aetrion/dnsimple-developer.git","svn_url":"https://github.com/aetrion/dnsimple-developer","homepage":"https://developer.dnsimple.com/","size":697,"stargazers_count":18,"watchers_count":18,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":18,"mirror_url":null,"open_issues_count":5,"forks":18,"open_issues":5,"watchers":18,"default_branch":"master"}},"base":{"label":"aetrion:master","ref":"master","sha":"36533d3258c748cf6477abb724554ef48181656f","user":{"login":"aetrion","id":323774,"avatar_url":"https://avatars.githubusercontent.com/u/323774?v=3","gravatar_id":"","url":"https://api.github.com/users/aetrion","html_url":"https://github.com/aetrion","followers_url":"https://api.github.com/users/aetrion/followers","following_url":"https://api.github.com/users/aetrion/following{/other_user}","gists_url":"https://api.github.com/users/aetrion/gists{/gist_id}","starred_url":"https://api.github.com/users/aetrion/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/aetrion/subscriptions","organizations_url":"https://api.github.com/users/aetrion/orgs","repos_url":"https://api.github.com/users/aetrion/repos","events_url":"https://api.github.com/users/aetrion/events{/privacy}","received_events_url":"https://api.github.com/users/aetrion/received_events","type":"Organization","site_admin":false},"repo":{"id":5965968,"name":"dnsimple-developer","full_name":"aetrion/dnsimple-developer","owner":{"login":"aetrion","id":323774,"avatar_url":"https://avatars.githubusercontent.com/u/323774?v=3","gravatar_id":"","url":"https://api.github.com/users/aetrion","html_url":"https://github.com/aetrion","followers_url":"https://api.github.com/users/aetrion/followers","following_url":"https://api.github.com/users/aetrion/following{/other_user}","gists_url":"https://api.github.com/users/aetrion/gists{/gist_id}","starred_url":"https://api.github.com/users/aetrion/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/aetrion/subscriptions","organizations_url":"https://api.github.com/users/aetrion/orgs","repos_url":"https://api.github.com/users/aetrion/repos","events_url":"https://api.github.com/users/aetrion/events{/privacy}","received_events_url":"https://api.github.com/users/aetrion/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/aetrion/dnsimple-developer","description":"The DNSimple API Documentation.","fork":false,"url":"https://api.github.com/repos/aetrion/dnsimple-developer","forks_url":"https://api.github.com/repos/aetrion/dnsimple-developer/forks","keys_url":"https://api.github.com/repos/aetrion/dnsimple-developer/keys{/key_id}","collaborators_url":"https://api.github.com/repos/aetrion/dnsimple-developer/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/aetrion/dnsimple-developer/teams","hooks_url":"https://api.github.com/repos/aetrion/dnsimple-developer/hooks","issue_events_url":"https://api.github.com/repos/aetrion/dnsimple-developer/issues/events{/number}","events_url":"https://api.github.com/repos/aetrion/dnsimple-developer/events","assignees_url":"https://api.github.com/repos/aetrion/dnsimple-developer/assignees{/user}","branches_url":"https://api.github.com/repos/aetrion/dnsimple-developer/branches{/branch}","tags_url":"https://api.github.com/repos/aetrion/dnsimple-developer/tags","blobs_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/refs{/sha}","trees_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/trees{/sha}","statuses_url":"https://api.github.com/repos/aetrion/dnsimple-developer/statuses/{sha}","languages_url":"https://api.github.com/repos/aetrion/dnsimple-developer/languages","stargazers_url":"https://api.github.com/repos/aetrion/dnsimple-developer/stargazers","contributors_url":"https://api.github.com/repos/aetrion/dnsimple-developer/contributors","subscribers_url":"https://api.github.com/repos/aetrion/dnsimple-developer/subscribers","subscription_url":"https://api.github.com/repos/aetrion/dnsimple-developer/subscription","commits_url":"https://api.github.com/repos/aetrion/dnsimple-developer/commits{/sha}","git_commits_url":"https://api.github.com/repos/aetrion/dnsimple-developer/git/commits{/sha}","comments_url":"https://api.github.com/repos/aetrion/dnsimple-developer/comments{/number}","issue_comment_url":"https://api.github.com/repos/aetrion/dnsimple-developer/issues/comments{/number}","contents_url":"https://api.github.com/repos/aetrion/dnsimple-developer/contents/{+path}","compare_url":"https://api.github.com/repos/aetrion/dnsimple-developer/compare/{base}...{head}","merges_url":"https://api.github.com/repos/aetrion/dnsimple-developer/merges","archive_url":"https://api.github.com/repos/aetrion/dnsimple-developer/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/aetrion/dnsimple-developer/downloads","issues_url":"https://api.github.com/repos/aetrion/dnsimple-developer/issues{/number}","pulls_url":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls{/number}","milestones_url":"https://api.github.com/repos/aetrion/dnsimple-developer/milestones{/number}","notifications_url":"https://api.github.com/repos/aetrion/dnsimple-developer/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/aetrion/dnsimple-developer/labels{/name}","releases_url":"https://api.github.com/repos/aetrion/dnsimple-developer/releases{/id}","deployments_url":"https://api.github.com/repos/aetrion/dnsimple-developer/deployments","created_at":"2012-09-26T13:13:01Z","updated_at":"2016-01-16T16:01:32Z","pushed_at":"2016-05-10T10:47:05Z","git_url":"git://github.com/aetrion/dnsimple-developer.git","ssh_url":"git@github.com:aetrion/dnsimple-developer.git","clone_url":"https://github.com/aetrion/dnsimple-developer.git","svn_url":"https://github.com/aetrion/dnsimple-developer","homepage":"https://developer.dnsimple.com/","size":697,"stargazers_count":18,"watchers_count":18,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":18,"mirror_url":null,"open_issues_count":5,"forks":18,"open_issues":5,"watchers":18,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/72"},"html":{"href":"https://github.com/aetrion/dnsimple-developer/pull/72"},"issue":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/issues/72"},"comments":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/issues/72/comments"},"review_comments":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/72/comments"},"review_comment":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/pulls/72/commits"},"statuses":{"href":"https://api.github.com/repos/aetrion/dnsimple-developer/statuses/784ed7d05a96926ff6d599e5fdce41ac973efc5a"}}}}