{"action":"created","comment":{"url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/comments/66427467","id":66427467,"diff_hunk":"@@ -0,0 +1,339 @@\n+---\n+layout: post\n+authors: [kevin_van_houtte]\n+title: 'Spring I/O 16: Test-driven documentation with Spring REST Docs'\n+image: /img/springio.jpg\n+tags: [Spring IO,Spring,Conference]\n+category: conference\n+comments: true\n+---\n+\n+## Spring IO 2016\n+The main focus this year was definitely about Cloud, Reactive and MicroServices.\n+But to complete this story we will need to document the REST API. \n+Keep calm, you don't have to do it manually! \n+Spring made it easy for us with Spring Rest Docs! \n+This year in Spring IO, Andy Wilkinson himself talked about why, how and when Spring Rest Docs are being used. \n+Last but not least, he talked about the new features that came out in version 1.1.\n+Since I implemented Spring REST Docs in a project, I'll use examples from my experiences.\n+\n+\n+<img class=\"p-image float-image\" width=\"200\" alt=\"Andy Wilkinson\" src=\"/img/rest-docs/andywilkinson.jpg\">\n+\n+### Andy Wilkinson\n+\n+Andy is a Spring Boot, REST docs committer and Spring IO platform lead at Pivotal. \n+You can find him on Twitter using the handle [@ankinson](https://twitter.com/ankinson).\n+\n+<blockquote class=\"clear\"><p>\n+Writing documentation is critical in the world of development. \n+It is used to make a accurate and straight declaration and intent of what the service has to offer. \n+Front-End developers will be able to know which endpoints they have to call and receive the right resource. \n+Now we all know it's tedious for developers to write documentation...","path":"_posts/2016-05-24-SpringIO16-Spring-Rest-Docs.md","position":32,"original_position":32,"commit_id":"016bea1b25f9086a39fea6c4c8365a11f7956157","original_commit_id":"016bea1b25f9086a39fea6c4c8365a11f7956157","user":{"login":"yannickdeturck","id":1644089,"avatar_url":"https://avatars.githubusercontent.com/u/1644089?v=3","gravatar_id":"","url":"https://api.github.com/users/yannickdeturck","html_url":"https://github.com/yannickdeturck","followers_url":"https://api.github.com/users/yannickdeturck/followers","following_url":"https://api.github.com/users/yannickdeturck/following{/other_user}","gists_url":"https://api.github.com/users/yannickdeturck/gists{/gist_id}","starred_url":"https://api.github.com/users/yannickdeturck/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/yannickdeturck/subscriptions","organizations_url":"https://api.github.com/users/yannickdeturck/orgs","repos_url":"https://api.github.com/users/yannickdeturck/repos","events_url":"https://api.github.com/users/yannickdeturck/events{/privacy}","received_events_url":"https://api.github.com/users/yannickdeturck/received_events","type":"User","site_admin":false},"body":"Would add a comma:\r\nNow**,** we all know ...","created_at":"2016-06-09T12:00:23Z","updated_at":"2016-06-09T12:00:23Z","html_url":"https://github.com/ordina-jworks/ordina-jworks.github.io/pull/71#discussion_r66427467","pull_request_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/71","_links":{"self":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/comments/66427467"},"html":{"href":"https://github.com/ordina-jworks/ordina-jworks.github.io/pull/71#discussion_r66427467"},"pull_request":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/71"}}},"pull_request":{"url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/71","id":73186811,"html_url":"https://github.com/ordina-jworks/ordina-jworks.github.io/pull/71","diff_url":"https://github.com/ordina-jworks/ordina-jworks.github.io/pull/71.diff","patch_url":"https://github.com/ordina-jworks/ordina-jworks.github.io/pull/71.patch","issue_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues/71","number":71,"state":"open","locked":false,"title":"Spring I/O Spring REST Docs postblog","user":{"login":"KevinDaHub","id":3090371,"avatar_url":"https://avatars.githubusercontent.com/u/3090371?v=3","gravatar_id":"","url":"https://api.github.com/users/KevinDaHub","html_url":"https://github.com/KevinDaHub","followers_url":"https://api.github.com/users/KevinDaHub/followers","following_url":"https://api.github.com/users/KevinDaHub/following{/other_user}","gists_url":"https://api.github.com/users/KevinDaHub/gists{/gist_id}","starred_url":"https://api.github.com/users/KevinDaHub/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/KevinDaHub/subscriptions","organizations_url":"https://api.github.com/users/KevinDaHub/orgs","repos_url":"https://api.github.com/users/KevinDaHub/repos","events_url":"https://api.github.com/users/KevinDaHub/events{/privacy}","received_events_url":"https://api.github.com/users/KevinDaHub/received_events","type":"User","site_admin":false},"body":"","created_at":"2016-06-09T10:00:48Z","updated_at":"2016-06-09T12:00:23Z","closed_at":null,"merged_at":null,"merge_commit_sha":"ad22c0fe746c494a9579f66e5ae0735d51cb74a1","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/71/commits","review_comments_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/71/comments","review_comment_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues/71/comments","statuses_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/statuses/016bea1b25f9086a39fea6c4c8365a11f7956157","head":{"label":"ordina-jworks:springIO-RestDocs","ref":"springIO-RestDocs","sha":"016bea1b25f9086a39fea6c4c8365a11f7956157","user":{"login":"ordina-jworks","id":15261659,"avatar_url":"https://avatars.githubusercontent.com/u/15261659?v=3","gravatar_id":"","url":"https://api.github.com/users/ordina-jworks","html_url":"https://github.com/ordina-jworks","followers_url":"https://api.github.com/users/ordina-jworks/followers","following_url":"https://api.github.com/users/ordina-jworks/following{/other_user}","gists_url":"https://api.github.com/users/ordina-jworks/gists{/gist_id}","starred_url":"https://api.github.com/users/ordina-jworks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ordina-jworks/subscriptions","organizations_url":"https://api.github.com/users/ordina-jworks/orgs","repos_url":"https://api.github.com/users/ordina-jworks/repos","events_url":"https://api.github.com/users/ordina-jworks/events{/privacy}","received_events_url":"https://api.github.com/users/ordina-jworks/received_events","type":"Organization","site_admin":false},"repo":{"id":44804684,"name":"ordina-jworks.github.io","full_name":"ordina-jworks/ordina-jworks.github.io","owner":{"login":"ordina-jworks","id":15261659,"avatar_url":"https://avatars.githubusercontent.com/u/15261659?v=3","gravatar_id":"","url":"https://api.github.com/users/ordina-jworks","html_url":"https://github.com/ordina-jworks","followers_url":"https://api.github.com/users/ordina-jworks/followers","following_url":"https://api.github.com/users/ordina-jworks/following{/other_user}","gists_url":"https://api.github.com/users/ordina-jworks/gists{/gist_id}","starred_url":"https://api.github.com/users/ordina-jworks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ordina-jworks/subscriptions","organizations_url":"https://api.github.com/users/ordina-jworks/orgs","repos_url":"https://api.github.com/users/ordina-jworks/repos","events_url":"https://api.github.com/users/ordina-jworks/events{/privacy}","received_events_url":"https://api.github.com/users/ordina-jworks/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ordina-jworks/ordina-jworks.github.io","description":"Ordina JWorks Business Unit Tech Blog","fork":false,"url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io","forks_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/forks","keys_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/teams","hooks_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/hooks","issue_events_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/events","assignees_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/tags","blobs_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/languages","stargazers_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/stargazers","contributors_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/contributors","subscribers_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/subscribers","subscription_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/subscription","commits_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/merges","archive_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/downloads","issues_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/labels{/name}","releases_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/deployments","created_at":"2015-10-23T09:56:09Z","updated_at":"2016-04-18T20:33:59Z","pushed_at":"2016-06-09T10:00:48Z","git_url":"git://github.com/ordina-jworks/ordina-jworks.github.io.git","ssh_url":"git@github.com:ordina-jworks/ordina-jworks.github.io.git","clone_url":"https://github.com/ordina-jworks/ordina-jworks.github.io.git","svn_url":"https://github.com/ordina-jworks/ordina-jworks.github.io","homepage":"","size":30039,"stargazers_count":4,"watchers_count":4,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":0,"mirror_url":null,"open_issues_count":6,"forks":0,"open_issues":6,"watchers":4,"default_branch":"source"}},"base":{"label":"ordina-jworks:source","ref":"source","sha":"8e79ec783be6bcb259e9ee2a9990b376f37c8adf","user":{"login":"ordina-jworks","id":15261659,"avatar_url":"https://avatars.githubusercontent.com/u/15261659?v=3","gravatar_id":"","url":"https://api.github.com/users/ordina-jworks","html_url":"https://github.com/ordina-jworks","followers_url":"https://api.github.com/users/ordina-jworks/followers","following_url":"https://api.github.com/users/ordina-jworks/following{/other_user}","gists_url":"https://api.github.com/users/ordina-jworks/gists{/gist_id}","starred_url":"https://api.github.com/users/ordina-jworks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ordina-jworks/subscriptions","organizations_url":"https://api.github.com/users/ordina-jworks/orgs","repos_url":"https://api.github.com/users/ordina-jworks/repos","events_url":"https://api.github.com/users/ordina-jworks/events{/privacy}","received_events_url":"https://api.github.com/users/ordina-jworks/received_events","type":"Organization","site_admin":false},"repo":{"id":44804684,"name":"ordina-jworks.github.io","full_name":"ordina-jworks/ordina-jworks.github.io","owner":{"login":"ordina-jworks","id":15261659,"avatar_url":"https://avatars.githubusercontent.com/u/15261659?v=3","gravatar_id":"","url":"https://api.github.com/users/ordina-jworks","html_url":"https://github.com/ordina-jworks","followers_url":"https://api.github.com/users/ordina-jworks/followers","following_url":"https://api.github.com/users/ordina-jworks/following{/other_user}","gists_url":"https://api.github.com/users/ordina-jworks/gists{/gist_id}","starred_url":"https://api.github.com/users/ordina-jworks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ordina-jworks/subscriptions","organizations_url":"https://api.github.com/users/ordina-jworks/orgs","repos_url":"https://api.github.com/users/ordina-jworks/repos","events_url":"https://api.github.com/users/ordina-jworks/events{/privacy}","received_events_url":"https://api.github.com/users/ordina-jworks/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ordina-jworks/ordina-jworks.github.io","description":"Ordina JWorks Business Unit Tech Blog","fork":false,"url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io","forks_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/forks","keys_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/teams","hooks_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/hooks","issue_events_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/events","assignees_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/tags","blobs_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/languages","stargazers_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/stargazers","contributors_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/contributors","subscribers_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/subscribers","subscription_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/subscription","commits_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/merges","archive_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/downloads","issues_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/labels{/name}","releases_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/deployments","created_at":"2015-10-23T09:56:09Z","updated_at":"2016-04-18T20:33:59Z","pushed_at":"2016-06-09T10:00:48Z","git_url":"git://github.com/ordina-jworks/ordina-jworks.github.io.git","ssh_url":"git@github.com:ordina-jworks/ordina-jworks.github.io.git","clone_url":"https://github.com/ordina-jworks/ordina-jworks.github.io.git","svn_url":"https://github.com/ordina-jworks/ordina-jworks.github.io","homepage":"","size":30039,"stargazers_count":4,"watchers_count":4,"language":"CSS","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":0,"mirror_url":null,"open_issues_count":6,"forks":0,"open_issues":6,"watchers":4,"default_branch":"source"}},"_links":{"self":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/71"},"html":{"href":"https://github.com/ordina-jworks/ordina-jworks.github.io/pull/71"},"issue":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues/71"},"comments":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/issues/71/comments"},"review_comments":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/71/comments"},"review_comment":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/pulls/71/commits"},"statuses":{"href":"https://api.github.com/repos/ordina-jworks/ordina-jworks.github.io/statuses/016bea1b25f9086a39fea6c4c8365a11f7956157"}}}}
{"actor":{"display_login":"yannickdeturck"}}