{"action":"created","comment":{"url":"https://api.github.com/repos/Kinto/kinto/pulls/comments/37849705","id":37849705,"diff_hunk":"@@ -24,23 +24,26 @@ A collection is a mapping with the following attribute:\n     Collection on a the default bucket are created silently on first access.","path":"docs/api/collections.rst","position":1,"original_position":1,"commit_id":"6924b60b7a60aa16ed31b216e8a8a76a81f96b53","original_commit_id":"6924b60b7a60aa16ed31b216e8a8a76a81f96b53","user":{"login":"phrawzty","id":625232,"avatar_url":"https://avatars.githubusercontent.com/u/625232?v=3","gravatar_id":"","url":"https://api.github.com/users/phrawzty","html_url":"https://github.com/phrawzty","followers_url":"https://api.github.com/users/phrawzty/followers","following_url":"https://api.github.com/users/phrawzty/following{/other_user}","gists_url":"https://api.github.com/users/phrawzty/gists{/gist_id}","starred_url":"https://api.github.com/users/phrawzty/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/phrawzty/subscriptions","organizations_url":"https://api.github.com/users/phrawzty/orgs","repos_url":"https://api.github.com/users/phrawzty/repos","events_url":"https://api.github.com/users/phrawzty/events{/privacy}","received_events_url":"https://api.github.com/users/phrawzty/received_events","type":"User","site_admin":false},"body":"I'm honestly not sure what this sentence means. :confused: ","created_at":"2015-08-25T09:54:31Z","updated_at":"2015-08-25T09:54:31Z","html_url":"https://github.com/Kinto/kinto/pull/156#discussion_r37849705","pull_request_url":"https://api.github.com/repos/Kinto/kinto/pulls/156","_links":{"self":{"href":"https://api.github.com/repos/Kinto/kinto/pulls/comments/37849705"},"html":{"href":"https://github.com/Kinto/kinto/pull/156#discussion_r37849705"},"pull_request":{"href":"https://api.github.com/repos/Kinto/kinto/pulls/156"}}},"pull_request":{"url":"https://api.github.com/repos/Kinto/kinto/pulls/156","id":42341687,"html_url":"https://github.com/Kinto/kinto/pull/156","diff_url":"https://github.com/Kinto/kinto/pull/156.diff","patch_url":"https://github.com/Kinto/kinto/pull/156.patch","issue_url":"https://api.github.com/repos/Kinto/kinto/issues/156","number":156,"state":"open","locked":false,"title":"Documentation returns","user":{"login":"ametaireau","id":67073,"avatar_url":"https://avatars.githubusercontent.com/u/67073?v=3","gravatar_id":"","url":"https://api.github.com/users/ametaireau","html_url":"https://github.com/ametaireau","followers_url":"https://api.github.com/users/ametaireau/followers","following_url":"https://api.github.com/users/ametaireau/following{/other_user}","gists_url":"https://api.github.com/users/ametaireau/gists{/gist_id}","starred_url":"https://api.github.com/users/ametaireau/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ametaireau/subscriptions","organizations_url":"https://api.github.com/users/ametaireau/orgs","repos_url":"https://api.github.com/users/ametaireau/repos","events_url":"https://api.github.com/users/ametaireau/events{/privacy}","received_events_url":"https://api.github.com/users/ametaireau/received_events","type":"User","site_admin":false},"body":"This pull request makes the documentation easier to grasp, and aims to facilitate the integration with the *Cliquet* documentation.\r\n\r\n- [x] Display sections in the documentation index;\r\n- [x] List all HTTP endpoints in a table for easier access;\r\n- [x] Include useful *Cliquet* docs;\r\n- [x] Remove all notions of *Cliquet*;\r\n- [x] Rework the rationale page;\r\n- [x] Prepare a FAQ;\r\n- [x] Rework the concepts page;\r\n- [x] Make it easier to contribute;\r\n- [x] Rework the configuration section;\r\n\r\nOpen questions:\r\n- Should we put the FAQ in the rationale page?\r\n- Should we put the comparison table in the rationale page?\r\n\r\nIndex page:\r\n![Index page](https://cloud.githubusercontent.com/assets/67073/9249135/9e5daf64-41c2-11e5-8677-178e29d30588.png)\r\n\r\nHTTP API reference:\r\n![HTTP API reference](https://cloud.githubusercontent.com/assets/67073/9249134/9e565908-41c2-11e5-9715-7a759c1e8431.png)\r\n\r\nComparison table:\r\n![comparison](https://cloud.githubusercontent.com/assets/67073/9254303/1c85406c-41e3-11e5-908b-63e5298858da.png)\r\n","created_at":"2015-08-13T11:51:32Z","updated_at":"2015-08-25T09:54:31Z","closed_at":null,"merged_at":null,"merge_commit_sha":"140a3aff0a6c2fa8605269db1602b25ff6de4380","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/Kinto/kinto/pulls/156/commits","review_comments_url":"https://api.github.com/repos/Kinto/kinto/pulls/156/comments","review_comment_url":"https://api.github.com/repos/Kinto/kinto/pulls/comments{/number}","comments_url":"https://api.github.com/repos/Kinto/kinto/issues/156/comments","statuses_url":"https://api.github.com/repos/Kinto/kinto/statuses/6924b60b7a60aa16ed31b216e8a8a76a81f96b53","head":{"label":"Kinto:documentation-returns","ref":"documentation-returns","sha":"6924b60b7a60aa16ed31b216e8a8a76a81f96b53","user":{"login":"Kinto","id":13413813,"avatar_url":"https://avatars.githubusercontent.com/u/13413813?v=3","gravatar_id":"","url":"https://api.github.com/users/Kinto","html_url":"https://github.com/Kinto","followers_url":"https://api.github.com/users/Kinto/followers","following_url":"https://api.github.com/users/Kinto/following{/other_user}","gists_url":"https://api.github.com/users/Kinto/gists{/gist_id}","starred_url":"https://api.github.com/users/Kinto/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Kinto/subscriptions","organizations_url":"https://api.github.com/users/Kinto/orgs","repos_url":"https://api.github.com/users/Kinto/repos","events_url":"https://api.github.com/users/Kinto/events{/privacy}","received_events_url":"https://api.github.com/users/Kinto/received_events","type":"Organization","site_admin":false},"repo":{"id":31315021,"name":"kinto","full_name":"Kinto/kinto","owner":{"login":"Kinto","id":13413813,"avatar_url":"https://avatars.githubusercontent.com/u/13413813?v=3","gravatar_id":"","url":"https://api.github.com/users/Kinto","html_url":"https://github.com/Kinto","followers_url":"https://api.github.com/users/Kinto/followers","following_url":"https://api.github.com/users/Kinto/following{/other_user}","gists_url":"https://api.github.com/users/Kinto/gists{/gist_id}","starred_url":"https://api.github.com/users/Kinto/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Kinto/subscriptions","organizations_url":"https://api.github.com/users/Kinto/orgs","repos_url":"https://api.github.com/users/Kinto/repos","events_url":"https://api.github.com/users/Kinto/events{/privacy}","received_events_url":"https://api.github.com/users/Kinto/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Kinto/kinto","description":"store, sync. rinse and repeat.","fork":false,"url":"https://api.github.com/repos/Kinto/kinto","forks_url":"https://api.github.com/repos/Kinto/kinto/forks","keys_url":"https://api.github.com/repos/Kinto/kinto/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Kinto/kinto/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Kinto/kinto/teams","hooks_url":"https://api.github.com/repos/Kinto/kinto/hooks","issue_events_url":"https://api.github.com/repos/Kinto/kinto/issues/events{/number}","events_url":"https://api.github.com/repos/Kinto/kinto/events","assignees_url":"https://api.github.com/repos/Kinto/kinto/assignees{/user}","branches_url":"https://api.github.com/repos/Kinto/kinto/branches{/branch}","tags_url":"https://api.github.com/repos/Kinto/kinto/tags","blobs_url":"https://api.github.com/repos/Kinto/kinto/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Kinto/kinto/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Kinto/kinto/git/refs{/sha}","trees_url":"https://api.github.com/repos/Kinto/kinto/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Kinto/kinto/statuses/{sha}","languages_url":"https://api.github.com/repos/Kinto/kinto/languages","stargazers_url":"https://api.github.com/repos/Kinto/kinto/stargazers","contributors_url":"https://api.github.com/repos/Kinto/kinto/contributors","subscribers_url":"https://api.github.com/repos/Kinto/kinto/subscribers","subscription_url":"https://api.github.com/repos/Kinto/kinto/subscription","commits_url":"https://api.github.com/repos/Kinto/kinto/commits{/sha}","git_commits_url":"https://api.github.com/repos/Kinto/kinto/git/commits{/sha}","comments_url":"https://api.github.com/repos/Kinto/kinto/comments{/number}","issue_comment_url":"https://api.github.com/repos/Kinto/kinto/issues/comments{/number}","contents_url":"https://api.github.com/repos/Kinto/kinto/contents/{+path}","compare_url":"https://api.github.com/repos/Kinto/kinto/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Kinto/kinto/merges","archive_url":"https://api.github.com/repos/Kinto/kinto/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Kinto/kinto/downloads","issues_url":"https://api.github.com/repos/Kinto/kinto/issues{/number}","pulls_url":"https://api.github.com/repos/Kinto/kinto/pulls{/number}","milestones_url":"https://api.github.com/repos/Kinto/kinto/milestones{/number}","notifications_url":"https://api.github.com/repos/Kinto/kinto/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Kinto/kinto/labels{/name}","releases_url":"https://api.github.com/repos/Kinto/kinto/releases{/id}","created_at":"2015-02-25T13:34:23Z","updated_at":"2015-08-13T02:04:55Z","pushed_at":"2015-08-24T16:03:03Z","git_url":"git://github.com/Kinto/kinto.git","ssh_url":"git@github.com:Kinto/kinto.git","clone_url":"https://github.com/Kinto/kinto.git","svn_url":"https://github.com/Kinto/kinto","homepage":"http://kinto.readthedocs.org/","size":1796,"stargazers_count":14,"watchers_count":14,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":7,"mirror_url":null,"open_issues_count":28,"forks":7,"open_issues":28,"watchers":14,"default_branch":"master"}},"base":{"label":"Kinto:master","ref":"master","sha":"803aea1d1ecefbb1b463492452fc83d37b03fca2","user":{"login":"Kinto","id":13413813,"avatar_url":"https://avatars.githubusercontent.com/u/13413813?v=3","gravatar_id":"","url":"https://api.github.com/users/Kinto","html_url":"https://github.com/Kinto","followers_url":"https://api.github.com/users/Kinto/followers","following_url":"https://api.github.com/users/Kinto/following{/other_user}","gists_url":"https://api.github.com/users/Kinto/gists{/gist_id}","starred_url":"https://api.github.com/users/Kinto/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Kinto/subscriptions","organizations_url":"https://api.github.com/users/Kinto/orgs","repos_url":"https://api.github.com/users/Kinto/repos","events_url":"https://api.github.com/users/Kinto/events{/privacy}","received_events_url":"https://api.github.com/users/Kinto/received_events","type":"Organization","site_admin":false},"repo":{"id":31315021,"name":"kinto","full_name":"Kinto/kinto","owner":{"login":"Kinto","id":13413813,"avatar_url":"https://avatars.githubusercontent.com/u/13413813?v=3","gravatar_id":"","url":"https://api.github.com/users/Kinto","html_url":"https://github.com/Kinto","followers_url":"https://api.github.com/users/Kinto/followers","following_url":"https://api.github.com/users/Kinto/following{/other_user}","gists_url":"https://api.github.com/users/Kinto/gists{/gist_id}","starred_url":"https://api.github.com/users/Kinto/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Kinto/subscriptions","organizations_url":"https://api.github.com/users/Kinto/orgs","repos_url":"https://api.github.com/users/Kinto/repos","events_url":"https://api.github.com/users/Kinto/events{/privacy}","received_events_url":"https://api.github.com/users/Kinto/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/Kinto/kinto","description":"store, sync. rinse and repeat.","fork":false,"url":"https://api.github.com/repos/Kinto/kinto","forks_url":"https://api.github.com/repos/Kinto/kinto/forks","keys_url":"https://api.github.com/repos/Kinto/kinto/keys{/key_id}","collaborators_url":"https://api.github.com/repos/Kinto/kinto/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/Kinto/kinto/teams","hooks_url":"https://api.github.com/repos/Kinto/kinto/hooks","issue_events_url":"https://api.github.com/repos/Kinto/kinto/issues/events{/number}","events_url":"https://api.github.com/repos/Kinto/kinto/events","assignees_url":"https://api.github.com/repos/Kinto/kinto/assignees{/user}","branches_url":"https://api.github.com/repos/Kinto/kinto/branches{/branch}","tags_url":"https://api.github.com/repos/Kinto/kinto/tags","blobs_url":"https://api.github.com/repos/Kinto/kinto/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/Kinto/kinto/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/Kinto/kinto/git/refs{/sha}","trees_url":"https://api.github.com/repos/Kinto/kinto/git/trees{/sha}","statuses_url":"https://api.github.com/repos/Kinto/kinto/statuses/{sha}","languages_url":"https://api.github.com/repos/Kinto/kinto/languages","stargazers_url":"https://api.github.com/repos/Kinto/kinto/stargazers","contributors_url":"https://api.github.com/repos/Kinto/kinto/contributors","subscribers_url":"https://api.github.com/repos/Kinto/kinto/subscribers","subscription_url":"https://api.github.com/repos/Kinto/kinto/subscription","commits_url":"https://api.github.com/repos/Kinto/kinto/commits{/sha}","git_commits_url":"https://api.github.com/repos/Kinto/kinto/git/commits{/sha}","comments_url":"https://api.github.com/repos/Kinto/kinto/comments{/number}","issue_comment_url":"https://api.github.com/repos/Kinto/kinto/issues/comments{/number}","contents_url":"https://api.github.com/repos/Kinto/kinto/contents/{+path}","compare_url":"https://api.github.com/repos/Kinto/kinto/compare/{base}...{head}","merges_url":"https://api.github.com/repos/Kinto/kinto/merges","archive_url":"https://api.github.com/repos/Kinto/kinto/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/Kinto/kinto/downloads","issues_url":"https://api.github.com/repos/Kinto/kinto/issues{/number}","pulls_url":"https://api.github.com/repos/Kinto/kinto/pulls{/number}","milestones_url":"https://api.github.com/repos/Kinto/kinto/milestones{/number}","notifications_url":"https://api.github.com/repos/Kinto/kinto/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/Kinto/kinto/labels{/name}","releases_url":"https://api.github.com/repos/Kinto/kinto/releases{/id}","created_at":"2015-02-25T13:34:23Z","updated_at":"2015-08-13T02:04:55Z","pushed_at":"2015-08-24T16:03:03Z","git_url":"git://github.com/Kinto/kinto.git","ssh_url":"git@github.com:Kinto/kinto.git","clone_url":"https://github.com/Kinto/kinto.git","svn_url":"https://github.com/Kinto/kinto","homepage":"http://kinto.readthedocs.org/","size":1796,"stargazers_count":14,"watchers_count":14,"language":"Python","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":7,"mirror_url":null,"open_issues_count":28,"forks":7,"open_issues":28,"watchers":14,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/Kinto/kinto/pulls/156"},"html":{"href":"https://github.com/Kinto/kinto/pull/156"},"issue":{"href":"https://api.github.com/repos/Kinto/kinto/issues/156"},"comments":{"href":"https://api.github.com/repos/Kinto/kinto/issues/156/comments"},"review_comments":{"href":"https://api.github.com/repos/Kinto/kinto/pulls/156/comments"},"review_comment":{"href":"https://api.github.com/repos/Kinto/kinto/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/Kinto/kinto/pulls/156/commits"},"statuses":{"href":"https://api.github.com/repos/Kinto/kinto/statuses/6924b60b7a60aa16ed31b216e8a8a76a81f96b53"}}}}