{"action":"created","comment":{"url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/comments/72811536","id":72811536,"diff_hunk":"@@ -31,8 +31,32 @@ Links to other resources must be defined exclusively using [HAL](http://stateles\n preferably using standard [link relations](http://www.iana.org/assignments/link-relations/link-relations.xml).\n \n Clients and Servers are required to support `_links` with its `href` and `rel` attributes, not only at the root level\n-but also in nested objects. To reduce the effort needed by clients to process hypertext data from servers it's not recommended to serve data with CURIEs, URI templates or embedded resources. Nor is it required to support the HAL media type\n-`application/hal+json`.\n+but also in nested objects. To reduce the effort needed by clients to process hypertext data from servers it's not recommended to serve data with CURIEs, URI templates or embedded resources. Nor is it required to support the HAL media type `application/hal+json`. The following snippet specifies the HAL link structure in JSONSchema:","path":"hyper-media/Hypermedia.md","position":6,"original_position":6,"commit_id":"75beee90df2c13ca8f71986ce0a6706fbd92c5ee","original_commit_id":"75beee90df2c13ca8f71986ce0a6706fbd92c5ee","user":{"login":"fmueller","id":719827,"avatar_url":"https://avatars.githubusercontent.com/u/719827?v=3","gravatar_id":"","url":"https://api.github.com/users/fmueller","html_url":"https://github.com/fmueller","followers_url":"https://api.github.com/users/fmueller/followers","following_url":"https://api.github.com/users/fmueller/following{/other_user}","gists_url":"https://api.github.com/users/fmueller/gists{/gist_id}","starred_url":"https://api.github.com/users/fmueller/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fmueller/subscriptions","organizations_url":"https://api.github.com/users/fmueller/orgs","repos_url":"https://api.github.com/users/fmueller/repos","events_url":"https://api.github.com/users/fmueller/events{/privacy}","received_events_url":"https://api.github.com/users/fmueller/received_events","type":"User","site_admin":false},"body":"I'm not sure if we should exclude embedding resources here as we discuss embedding resources in other sections as well.","created_at":"2016-07-29T15:30:54Z","updated_at":"2016-07-29T15:30:54Z","html_url":"https://github.com/zalando/restful-api-guidelines/pull/109#discussion_r72811536","pull_request_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/109","_links":{"self":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/comments/72811536"},"html":{"href":"https://github.com/zalando/restful-api-guidelines/pull/109#discussion_r72811536"},"pull_request":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/109"}}},"pull_request":{"url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/109","id":78099208,"html_url":"https://github.com/zalando/restful-api-guidelines/pull/109","diff_url":"https://github.com/zalando/restful-api-guidelines/pull/109.diff","patch_url":"https://github.com/zalando/restful-api-guidelines/pull/109.patch","issue_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/109","number":109,"state":"open","locked":false,"title":"HAL Schema","user":{"login":"whiskeysierra","id":429981,"avatar_url":"https://avatars.githubusercontent.com/u/429981?v=3","gravatar_id":"","url":"https://api.github.com/users/whiskeysierra","html_url":"https://github.com/whiskeysierra","followers_url":"https://api.github.com/users/whiskeysierra/followers","following_url":"https://api.github.com/users/whiskeysierra/following{/other_user}","gists_url":"https://api.github.com/users/whiskeysierra/gists{/gist_id}","starred_url":"https://api.github.com/users/whiskeysierra/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/whiskeysierra/subscriptions","organizations_url":"https://api.github.com/users/whiskeysierra/orgs","repos_url":"https://api.github.com/users/whiskeysierra/repos","events_url":"https://api.github.com/users/whiskeysierra/events{/privacy}","received_events_url":"https://api.github.com/users/whiskeysierra/received_events","type":"User","site_admin":false},"body":"","created_at":"2016-07-20T07:20:29Z","updated_at":"2016-07-29T15:30:54Z","closed_at":null,"merged_at":null,"merge_commit_sha":"7e6bd527d38370898cef53b3017e117cbb3340e4","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/109/commits","review_comments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/109/comments","review_comment_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/comments{/number}","comments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/109/comments","statuses_url":"https://api.github.com/repos/zalando/restful-api-guidelines/statuses/75beee90df2c13ca8f71986ce0a6706fbd92c5ee","head":{"label":"zalando:feature/hal-schema","ref":"feature/hal-schema","sha":"75beee90df2c13ca8f71986ce0a6706fbd92c5ee","user":{"login":"zalando","id":1564818,"avatar_url":"https://avatars.githubusercontent.com/u/1564818?v=3","gravatar_id":"","url":"https://api.github.com/users/zalando","html_url":"https://github.com/zalando","followers_url":"https://api.github.com/users/zalando/followers","following_url":"https://api.github.com/users/zalando/following{/other_user}","gists_url":"https://api.github.com/users/zalando/gists{/gist_id}","starred_url":"https://api.github.com/users/zalando/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zalando/subscriptions","organizations_url":"https://api.github.com/users/zalando/orgs","repos_url":"https://api.github.com/users/zalando/repos","events_url":"https://api.github.com/users/zalando/events{/privacy}","received_events_url":"https://api.github.com/users/zalando/received_events","type":"Organization","site_admin":false},"repo":{"id":55240856,"name":"restful-api-guidelines","full_name":"zalando/restful-api-guidelines","owner":{"login":"zalando","id":1564818,"avatar_url":"https://avatars.githubusercontent.com/u/1564818?v=3","gravatar_id":"","url":"https://api.github.com/users/zalando","html_url":"https://github.com/zalando","followers_url":"https://api.github.com/users/zalando/followers","following_url":"https://api.github.com/users/zalando/following{/other_user}","gists_url":"https://api.github.com/users/zalando/gists{/gist_id}","starred_url":"https://api.github.com/users/zalando/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zalando/subscriptions","organizations_url":"https://api.github.com/users/zalando/orgs","repos_url":"https://api.github.com/users/zalando/repos","events_url":"https://api.github.com/users/zalando/events{/privacy}","received_events_url":"https://api.github.com/users/zalando/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/zalando/restful-api-guidelines","description":"A model set of guidelines for RESTful APIs, created by Zalando","fork":false,"url":"https://api.github.com/repos/zalando/restful-api-guidelines","forks_url":"https://api.github.com/repos/zalando/restful-api-guidelines/forks","keys_url":"https://api.github.com/repos/zalando/restful-api-guidelines/keys{/key_id}","collaborators_url":"https://api.github.com/repos/zalando/restful-api-guidelines/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/zalando/restful-api-guidelines/teams","hooks_url":"https://api.github.com/repos/zalando/restful-api-guidelines/hooks","issue_events_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/events{/number}","events_url":"https://api.github.com/repos/zalando/restful-api-guidelines/events","assignees_url":"https://api.github.com/repos/zalando/restful-api-guidelines/assignees{/user}","branches_url":"https://api.github.com/repos/zalando/restful-api-guidelines/branches{/branch}","tags_url":"https://api.github.com/repos/zalando/restful-api-guidelines/tags","blobs_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/refs{/sha}","trees_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/trees{/sha}","statuses_url":"https://api.github.com/repos/zalando/restful-api-guidelines/statuses/{sha}","languages_url":"https://api.github.com/repos/zalando/restful-api-guidelines/languages","stargazers_url":"https://api.github.com/repos/zalando/restful-api-guidelines/stargazers","contributors_url":"https://api.github.com/repos/zalando/restful-api-guidelines/contributors","subscribers_url":"https://api.github.com/repos/zalando/restful-api-guidelines/subscribers","subscription_url":"https://api.github.com/repos/zalando/restful-api-guidelines/subscription","commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/commits{/sha}","git_commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/commits{/sha}","comments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/comments{/number}","issue_comment_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/comments{/number}","contents_url":"https://api.github.com/repos/zalando/restful-api-guidelines/contents/{+path}","compare_url":"https://api.github.com/repos/zalando/restful-api-guidelines/compare/{base}...{head}","merges_url":"https://api.github.com/repos/zalando/restful-api-guidelines/merges","archive_url":"https://api.github.com/repos/zalando/restful-api-guidelines/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/zalando/restful-api-guidelines/downloads","issues_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues{/number}","pulls_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls{/number}","milestones_url":"https://api.github.com/repos/zalando/restful-api-guidelines/milestones{/number}","notifications_url":"https://api.github.com/repos/zalando/restful-api-guidelines/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/zalando/restful-api-guidelines/labels{/name}","releases_url":"https://api.github.com/repos/zalando/restful-api-guidelines/releases{/id}","deployments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/deployments","created_at":"2016-04-01T15:06:54Z","updated_at":"2016-07-29T09:38:45Z","pushed_at":"2016-07-29T15:07:51Z","git_url":"git://github.com/zalando/restful-api-guidelines.git","ssh_url":"git@github.com:zalando/restful-api-guidelines.git","clone_url":"https://github.com/zalando/restful-api-guidelines.git","svn_url":"https://github.com/zalando/restful-api-guidelines","homepage":"http://zalando.github.io/restful-api-guidelines/","size":5944,"stargazers_count":85,"watchers_count":85,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":18,"mirror_url":null,"open_issues_count":22,"forks":18,"open_issues":22,"watchers":85,"default_branch":"master"}},"base":{"label":"zalando:master","ref":"master","sha":"1be6defeb0e3ef482b547fbface8adf27e318259","user":{"login":"zalando","id":1564818,"avatar_url":"https://avatars.githubusercontent.com/u/1564818?v=3","gravatar_id":"","url":"https://api.github.com/users/zalando","html_url":"https://github.com/zalando","followers_url":"https://api.github.com/users/zalando/followers","following_url":"https://api.github.com/users/zalando/following{/other_user}","gists_url":"https://api.github.com/users/zalando/gists{/gist_id}","starred_url":"https://api.github.com/users/zalando/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zalando/subscriptions","organizations_url":"https://api.github.com/users/zalando/orgs","repos_url":"https://api.github.com/users/zalando/repos","events_url":"https://api.github.com/users/zalando/events{/privacy}","received_events_url":"https://api.github.com/users/zalando/received_events","type":"Organization","site_admin":false},"repo":{"id":55240856,"name":"restful-api-guidelines","full_name":"zalando/restful-api-guidelines","owner":{"login":"zalando","id":1564818,"avatar_url":"https://avatars.githubusercontent.com/u/1564818?v=3","gravatar_id":"","url":"https://api.github.com/users/zalando","html_url":"https://github.com/zalando","followers_url":"https://api.github.com/users/zalando/followers","following_url":"https://api.github.com/users/zalando/following{/other_user}","gists_url":"https://api.github.com/users/zalando/gists{/gist_id}","starred_url":"https://api.github.com/users/zalando/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/zalando/subscriptions","organizations_url":"https://api.github.com/users/zalando/orgs","repos_url":"https://api.github.com/users/zalando/repos","events_url":"https://api.github.com/users/zalando/events{/privacy}","received_events_url":"https://api.github.com/users/zalando/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/zalando/restful-api-guidelines","description":"A model set of guidelines for RESTful APIs, created by Zalando","fork":false,"url":"https://api.github.com/repos/zalando/restful-api-guidelines","forks_url":"https://api.github.com/repos/zalando/restful-api-guidelines/forks","keys_url":"https://api.github.com/repos/zalando/restful-api-guidelines/keys{/key_id}","collaborators_url":"https://api.github.com/repos/zalando/restful-api-guidelines/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/zalando/restful-api-guidelines/teams","hooks_url":"https://api.github.com/repos/zalando/restful-api-guidelines/hooks","issue_events_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/events{/number}","events_url":"https://api.github.com/repos/zalando/restful-api-guidelines/events","assignees_url":"https://api.github.com/repos/zalando/restful-api-guidelines/assignees{/user}","branches_url":"https://api.github.com/repos/zalando/restful-api-guidelines/branches{/branch}","tags_url":"https://api.github.com/repos/zalando/restful-api-guidelines/tags","blobs_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/refs{/sha}","trees_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/trees{/sha}","statuses_url":"https://api.github.com/repos/zalando/restful-api-guidelines/statuses/{sha}","languages_url":"https://api.github.com/repos/zalando/restful-api-guidelines/languages","stargazers_url":"https://api.github.com/repos/zalando/restful-api-guidelines/stargazers","contributors_url":"https://api.github.com/repos/zalando/restful-api-guidelines/contributors","subscribers_url":"https://api.github.com/repos/zalando/restful-api-guidelines/subscribers","subscription_url":"https://api.github.com/repos/zalando/restful-api-guidelines/subscription","commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/commits{/sha}","git_commits_url":"https://api.github.com/repos/zalando/restful-api-guidelines/git/commits{/sha}","comments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/comments{/number}","issue_comment_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/comments{/number}","contents_url":"https://api.github.com/repos/zalando/restful-api-guidelines/contents/{+path}","compare_url":"https://api.github.com/repos/zalando/restful-api-guidelines/compare/{base}...{head}","merges_url":"https://api.github.com/repos/zalando/restful-api-guidelines/merges","archive_url":"https://api.github.com/repos/zalando/restful-api-guidelines/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/zalando/restful-api-guidelines/downloads","issues_url":"https://api.github.com/repos/zalando/restful-api-guidelines/issues{/number}","pulls_url":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls{/number}","milestones_url":"https://api.github.com/repos/zalando/restful-api-guidelines/milestones{/number}","notifications_url":"https://api.github.com/repos/zalando/restful-api-guidelines/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/zalando/restful-api-guidelines/labels{/name}","releases_url":"https://api.github.com/repos/zalando/restful-api-guidelines/releases{/id}","deployments_url":"https://api.github.com/repos/zalando/restful-api-guidelines/deployments","created_at":"2016-04-01T15:06:54Z","updated_at":"2016-07-29T09:38:45Z","pushed_at":"2016-07-29T15:07:51Z","git_url":"git://github.com/zalando/restful-api-guidelines.git","ssh_url":"git@github.com:zalando/restful-api-guidelines.git","clone_url":"https://github.com/zalando/restful-api-guidelines.git","svn_url":"https://github.com/zalando/restful-api-guidelines","homepage":"http://zalando.github.io/restful-api-guidelines/","size":5944,"stargazers_count":85,"watchers_count":85,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":18,"mirror_url":null,"open_issues_count":22,"forks":18,"open_issues":22,"watchers":85,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/109"},"html":{"href":"https://github.com/zalando/restful-api-guidelines/pull/109"},"issue":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/109"},"comments":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/issues/109/comments"},"review_comments":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/109/comments"},"review_comment":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/pulls/109/commits"},"statuses":{"href":"https://api.github.com/repos/zalando/restful-api-guidelines/statuses/75beee90df2c13ca8f71986ce0a6706fbd92c5ee"}}}}
{"actor":{"display_login":"fmueller"}}