{"action":"created","comment":{"url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/comments/38112717","id":38112717,"diff_hunk":"@@ -0,0 +1,494 @@\n+Why did we make Cliquet?\n+########################\n+\n+:lang: en\n+:url: why-cliquet\n+:slug: post-cliquet-rationale\n+:date: 2015-07-14\n+:summary:\n+    Based on Pyramid, Cliquet is a project that allows you to concentrate on\n+    the essentials when building APIs.\n+\n+.. note::\n+\n+    Translated from the French by `Dan Phrawzty <https://twitter.com/phrawzty>`_.\n+\n+**tl;dr Cliquet is a Python toolkit for building APIs that implements best\n+practices in terms of production use and the HTTP protocol.**\n+\n+The Origins\n+===========\n+\n+The objective for the first trimester of 2015 was to build a service for\n+storage and the `synchronisation of a reading list\n+<{filename}2015.04.service-de-nuages.rst>`_. At the outset of the project we\n+tried assembling all of the best practices and recommendations from different\n+teams and currently deploy projects. Also, we wanted to take advantage of the\n+*Firefox Sync* protocol for offline sync since it's robust and proven.\n+\n+Rather than write `yet another <http://blog.octo.com/en/design-a-rest-api/>`_\n+`article <http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api>`_","path":"content/2015.07.cliquet.rationale-en.rst","position":30,"original_position":30,"commit_id":"facb799e1a24010932ccb8a139601ab6d3a7a7e7","original_commit_id":"facb799e1a24010932ccb8a139601ab6d3a7a7e7","user":{"login":"Natim","id":229453,"avatar_url":"https://avatars.githubusercontent.com/u/229453?v=3","gravatar_id":"","url":"https://api.github.com/users/Natim","html_url":"https://github.com/Natim","followers_url":"https://api.github.com/users/Natim/followers","following_url":"https://api.github.com/users/Natim/following{/other_user}","gists_url":"https://api.github.com/users/Natim/gists{/gist_id}","starred_url":"https://api.github.com/users/Natim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Natim/subscriptions","organizations_url":"https://api.github.com/users/Natim/orgs","repos_url":"https://api.github.com/users/Natim/repos","events_url":"https://api.github.com/users/Natim/events{/privacy}","received_events_url":"https://api.github.com/users/Natim/received_events","type":"User","site_admin":false},"body":"yet another ~article~~ solution? ","created_at":"2015-08-27T16:00:40Z","updated_at":"2015-08-27T16:00:40Z","html_url":"https://github.com/mozilla-services/servicedenuages.fr/pull/53#discussion_r38112717","pull_request_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/53","_links":{"self":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/comments/38112717"},"html":{"href":"https://github.com/mozilla-services/servicedenuages.fr/pull/53#discussion_r38112717"},"pull_request":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/53"}}},"pull_request":{"url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/53","id":43534290,"html_url":"https://github.com/mozilla-services/servicedenuages.fr/pull/53","diff_url":"https://github.com/mozilla-services/servicedenuages.fr/pull/53.diff","patch_url":"https://github.com/mozilla-services/servicedenuages.fr/pull/53.patch","issue_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/53","number":53,"state":"open","locked":false,"title":"translate why-cliquet into English","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":":eyes: :mag: :page_facing_up: ","created_at":"2015-08-27T15:55:09Z","updated_at":"2015-08-27T16:00:40Z","closed_at":null,"merged_at":null,"merge_commit_sha":"c4600d4df3ae6cd053dc38eed5ec2cdbec2ff5dc","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/53/commits","review_comments_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/53/comments","review_comment_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/comments{/number}","comments_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/53/comments","statuses_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/statuses/facb799e1a24010932ccb8a139601ab6d3a7a7e7","head":{"label":"phrawzty:cliquet_translate","ref":"cliquet_translate","sha":"facb799e1a24010932ccb8a139601ab6d3a7a7e7","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},"repo":{"id":39376437,"name":"servicedenuages.fr","full_name":"phrawzty/servicedenuages.fr","owner":{"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},"private":false,"html_url":"https://github.com/phrawzty/servicedenuages.fr","description":"Da french team blog.","fork":true,"url":"https://api.github.com/repos/phrawzty/servicedenuages.fr","forks_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/forks","keys_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/keys{/key_id}","collaborators_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/teams","hooks_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/hooks","issue_events_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/issues/events{/number}","events_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/events","assignees_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/assignees{/user}","branches_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/branches{/branch}","tags_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/tags","blobs_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/git/refs{/sha}","trees_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/git/trees{/sha}","statuses_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/statuses/{sha}","languages_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/languages","stargazers_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/stargazers","contributors_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/contributors","subscribers_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/subscribers","subscription_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/subscription","commits_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/commits{/sha}","git_commits_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/git/commits{/sha}","comments_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/comments{/number}","issue_comment_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/issues/comments{/number}","contents_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/contents/{+path}","compare_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/compare/{base}...{head}","merges_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/merges","archive_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/downloads","issues_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/issues{/number}","pulls_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/pulls{/number}","milestones_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/milestones{/number}","notifications_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/labels{/name}","releases_url":"https://api.github.com/repos/phrawzty/servicedenuages.fr/releases{/id}","created_at":"2015-07-20T09:59:12Z","updated_at":"2015-07-20T09:59:13Z","pushed_at":"2015-08-27T15:52:56Z","git_url":"git://github.com/phrawzty/servicedenuages.fr.git","ssh_url":"git@github.com:phrawzty/servicedenuages.fr.git","clone_url":"https://github.com/phrawzty/servicedenuages.fr.git","svn_url":"https://github.com/phrawzty/servicedenuages.fr","homepage":"http://www.servicedenuages.fr","size":4056,"stargazers_count":0,"watchers_count":0,"language":"CSS","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"mozilla-services:master","ref":"master","sha":"0c43e46d738d013702bb13cd3c3cbc3bf1b26972","user":{"login":"mozilla-services","id":1066228,"avatar_url":"https://avatars.githubusercontent.com/u/1066228?v=3","gravatar_id":"","url":"https://api.github.com/users/mozilla-services","html_url":"https://github.com/mozilla-services","followers_url":"https://api.github.com/users/mozilla-services/followers","following_url":"https://api.github.com/users/mozilla-services/following{/other_user}","gists_url":"https://api.github.com/users/mozilla-services/gists{/gist_id}","starred_url":"https://api.github.com/users/mozilla-services/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mozilla-services/subscriptions","organizations_url":"https://api.github.com/users/mozilla-services/orgs","repos_url":"https://api.github.com/users/mozilla-services/repos","events_url":"https://api.github.com/users/mozilla-services/events{/privacy}","received_events_url":"https://api.github.com/users/mozilla-services/received_events","type":"Organization","site_admin":false},"repo":{"id":34000996,"name":"servicedenuages.fr","full_name":"mozilla-services/servicedenuages.fr","owner":{"login":"mozilla-services","id":1066228,"avatar_url":"https://avatars.githubusercontent.com/u/1066228?v=3","gravatar_id":"","url":"https://api.github.com/users/mozilla-services","html_url":"https://github.com/mozilla-services","followers_url":"https://api.github.com/users/mozilla-services/followers","following_url":"https://api.github.com/users/mozilla-services/following{/other_user}","gists_url":"https://api.github.com/users/mozilla-services/gists{/gist_id}","starred_url":"https://api.github.com/users/mozilla-services/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/mozilla-services/subscriptions","organizations_url":"https://api.github.com/users/mozilla-services/orgs","repos_url":"https://api.github.com/users/mozilla-services/repos","events_url":"https://api.github.com/users/mozilla-services/events{/privacy}","received_events_url":"https://api.github.com/users/mozilla-services/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/mozilla-services/servicedenuages.fr","description":"Da french team blog.","fork":false,"url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr","forks_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/forks","keys_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/keys{/key_id}","collaborators_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/teams","hooks_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/hooks","issue_events_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/events{/number}","events_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/events","assignees_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/assignees{/user}","branches_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/branches{/branch}","tags_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/tags","blobs_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/git/refs{/sha}","trees_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/git/trees{/sha}","statuses_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/statuses/{sha}","languages_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/languages","stargazers_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/stargazers","contributors_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/contributors","subscribers_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/subscribers","subscription_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/subscription","commits_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/commits{/sha}","git_commits_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/git/commits{/sha}","comments_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/comments{/number}","issue_comment_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/comments{/number}","contents_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/contents/{+path}","compare_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/compare/{base}...{head}","merges_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/merges","archive_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/downloads","issues_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues{/number}","pulls_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls{/number}","milestones_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/milestones{/number}","notifications_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/labels{/name}","releases_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/releases{/id}","created_at":"2015-04-15T15:07:57Z","updated_at":"2015-08-27T13:07:27Z","pushed_at":"2015-08-27T15:55:09Z","git_url":"git://github.com/mozilla-services/servicedenuages.fr.git","ssh_url":"git@github.com:mozilla-services/servicedenuages.fr.git","clone_url":"https://github.com/mozilla-services/servicedenuages.fr.git","svn_url":"https://github.com/mozilla-services/servicedenuages.fr","homepage":"http://www.servicedenuages.fr","size":6321,"stargazers_count":3,"watchers_count":3,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":3,"mirror_url":null,"open_issues_count":6,"forks":3,"open_issues":6,"watchers":3,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/53"},"html":{"href":"https://github.com/mozilla-services/servicedenuages.fr/pull/53"},"issue":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/53"},"comments":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/53/comments"},"review_comments":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/53/comments"},"review_comment":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/53/commits"},"statuses":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/statuses/facb799e1a24010932ccb8a139601ab6d3a7a7e7"}}}}