{"action":"created","comment":{"url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/comments/30035528","id":30035528,"diff_hunk":"@@ -0,0 +1,246 @@\n+Retours des APIdays Barcelona\n+#############################\n+\n+:date: 2015-05-11\n+\n+Cette journée aux APIDays Barcelona a été d'une rare richesse ! Pour commencer, bravo à toute l'équipe et\n+tous les participants !\n+\n+Je vais tenter de faire un retour le plus complet possible, en restant un minimum concis :) S'il y a\n+des points obscurs, «*lache tes coms*» [#]_  !\n+\n+L'évènement\n+-----------\n+\n+`APIdays <http://mediterranea.apidays.io/>`_ est un évènement qui a lieu dans plusieurs villes,\n+et par chance aussi à Barcelone.\n+\n+Naïvement, je n'aurais jamais pensé qu'il puisse exister une communauté aussi forte autour des APIs !\n+Je découvre donc une nouvelle famille de passionnés, pluri-disciplinaire et agnostique \\o/.\n+Des participants de tous horizons, de la grosse multinationale aux obédiences XML/Java à la startup\n+hype en passant par des indépendants de toute sorte !\n+\n+\n+L'affordance\n+------------\n+\n+L'affordance, formulé par Don Norman, est un concept assez connu en ergonomie. Cela définit\n+la capacité d'un objet à transmettre ses fonctionnalités via son apparence. Pensez aux poignées\n+de porte, selon leur forme on sait si on doit pousser, tirer ou pousser.\n+\n+`Mike Amundsen <https://twitter.com/mamund>`_ ouvrait la journée en étendant le concept aux APIs.\n+Une API, et l'apparence des informations présentées, doit suggérer ce qu'on peut faire avec.\n+\n+Il a rappellé cependant que les meilleurs designs étaient ceux qui permettaient de faire des\n+choses choses auquelles les auteurs n'avaient pas pensé.\n+\n+> Tiens, ça me rapelle ça: http://lucumr.pocoo.org/2015/4/28/unintended-affordances/\n+\n+`Orlando Kalossakas <https://twitter.com/orliesaurus>`_ ajoutait plus tard dans la journée:\n+\n+    *A good API is hard to misuse*\n+\n+Hypermedia\n+----------\n+\n+Plusieurs fois dans la journée, les évangélistes et fins prédicateurs ont expliqué que le\n+monde des APIs était là où était le Web il y 15 ans. On a dépassé le stade d'utiliser\n+``GET /action=create`` et REST est bien implanté, mais l'accessibilité des APIs, leur\n+fédération, leur utilisation transparence ou leur caractère inter-changeable semble encore loin.\n+\n+Les APIs manquent de liens.\n+\n+.. epigraph::\n+\n+\n+    Hypermedia is just like hypertext but not limited to...text!\n+\n+\n+    -- `Ross Garett <https://twitter.com/gssor>`_\n+\n+\n+Le Web était initialement pensé comme une gigantesque base de données distribuée et\n+exploitable sans préconfiguration. Sur le tard, il y a eu diverses initiatives,\n+comme le Web sémantique, avec les `graphes d'ontologie`_, `RDF`_ ou les micro-formats. On devrait pouvoir dire\n+aujourd'hui que c'est un échec, car cela n'a pas été adopté partout.\n+\n+Mais, mais... il y a encore de l'espoir avec les APIs :) [#]_\n+\n+.. [#] http://sookocheff.com/posts/2014-03-11-on-choosing-a-hypermedia-format/ (gist: https://gist.github.com/soofaloofa/9350847)\n+\n+.. graphes d'ontologie: http://fr.wikipedia.org/wiki/Ontologie_%28informatique%29\n+.. RDF: http://fr.wikipedia.org/wiki/Resource_Description_Framework\n+\n+\n+Conventions\n+-----------\n+\n+En contrebas du Web ou des APIs sémantiques, il y a l'approche qui consiste à mettre au point des\n+conventions simples.\n+\n+`Steve Klabnik <https://twitter.com/steveklabnik>`_ qui a une culture Ruby a fait le parallèle\n+avec les frameworks Web et l'approche «*Convention over configuration*».\n+\n+C'est le cas de la `spécification JSON-API <http://jsonapi.org/>`_, qui ne cherche pas à aborder\n+les concepts de sémantique mais simplement d'économiser aux développeurs de débattre des\n+`choix inutiles <http://fr.wikipedia.org/wiki/Loi_de_futilit%C3%A9_de_Parkinson>`_.\n+\n+\n+.. figure:: http://transitionculture.org/wp-content/uploads/bikeshed2.jpg\n+    :align: center\n+    *I looked in Google Images and found this. I thought «that's not a bikeshed».\n+    OMG, I was actually bikeshedding about bikesheds! — Steve\n+\n+Par la même occasion, l'idée est de faciliter l'implémentation des clients, et `le composant data Ember.js <https://github.com/emberjs/data>`_\n+supportera la spec dans la prochaine release.\n+\n+Nos intentions pour `Cliquet <http://cliquet.readthedocs.org/en/latest/rationale.html#philosophy>`_ sont exactement celles-ci. Nous\n+allons donc `probablement converger <https://github.com/mozilla-services/cliquet/issues/254>`_. D'autant\n+que les spécs sont très proches.","path":"content/2015.05.retour-apidays.rst","position":99,"original_position":99,"commit_id":"3d8a509431fa7a59fb07a7cc4a797e9eb5f5c87a","original_commit_id":"3d8a509431fa7a59fb07a7cc4a797e9eb5f5c87a","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":"specs","created_at":"2015-05-11T13:02:10Z","updated_at":"2015-05-11T13:02:10Z","html_url":"https://github.com/mozilla-services/servicedenuages.fr/pull/20#discussion_r30035528","pull_request_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/20","_links":{"self":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/comments/30035528"},"html":{"href":"https://github.com/mozilla-services/servicedenuages.fr/pull/20#discussion_r30035528"},"pull_request":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/20"}}},"pull_request":{"url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/20","id":35119203,"html_url":"https://github.com/mozilla-services/servicedenuages.fr/pull/20","diff_url":"https://github.com/mozilla-services/servicedenuages.fr/pull/20.diff","patch_url":"https://github.com/mozilla-services/servicedenuages.fr/pull/20.patch","issue_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/20","number":20,"state":"open","locked":false,"title":"[WIP] Article retour des APIDays","user":{"login":"leplatrem","id":546692,"avatar_url":"https://avatars.githubusercontent.com/u/546692?v=3","gravatar_id":"","url":"https://api.github.com/users/leplatrem","html_url":"https://github.com/leplatrem","followers_url":"https://api.github.com/users/leplatrem/followers","following_url":"https://api.github.com/users/leplatrem/following{/other_user}","gists_url":"https://api.github.com/users/leplatrem/gists{/gist_id}","starred_url":"https://api.github.com/users/leplatrem/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/leplatrem/subscriptions","organizations_url":"https://api.github.com/users/leplatrem/orgs","repos_url":"https://api.github.com/users/leplatrem/repos","events_url":"https://api.github.com/users/leplatrem/events{/privacy}","received_events_url":"https://api.github.com/users/leplatrem/received_events","type":"User","site_admin":false},"body":"* [x] Draft\r\n* [ ] Add illustrations\r\n\r\nr?","created_at":"2015-05-11T11:38:41Z","updated_at":"2015-05-11T13:02:10Z","closed_at":null,"merged_at":null,"merge_commit_sha":"86dbbb73c899ddeac121aeddaaea4f29fff91097","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/20/commits","review_comments_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/20/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/20/comments","statuses_url":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/statuses/3d8a509431fa7a59fb07a7cc4a797e9eb5f5c87a","head":{"label":"mozilla-services:article-retour-apidays","ref":"article-retour-apidays","sha":"3d8a509431fa7a59fb07a7cc4a797e9eb5f5c87a","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-05-07T18:54:27Z","pushed_at":"2015-05-11T11:38:42Z","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":1952,"stargazers_count":1,"watchers_count":1,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1,"mirror_url":null,"open_issues_count":4,"forks":1,"open_issues":4,"watchers":1,"default_branch":"master"}},"base":{"label":"mozilla-services:master","ref":"master","sha":"0a6d319a7017be3988bdd6f967408245f487843f","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-05-07T18:54:27Z","pushed_at":"2015-05-11T11:38:42Z","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":1952,"stargazers_count":1,"watchers_count":1,"language":"HTML","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":1,"mirror_url":null,"open_issues_count":4,"forks":1,"open_issues":4,"watchers":1,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/20"},"html":{"href":"https://github.com/mozilla-services/servicedenuages.fr/pull/20"},"issue":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/20"},"comments":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/issues/20/comments"},"review_comments":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/pulls/20/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/20/commits"},"statuses":{"href":"https://api.github.com/repos/mozilla-services/servicedenuages.fr/statuses/3d8a509431fa7a59fb07a7cc4a797e9eb5f5c87a"}}}}