{"action":"created","comment":{"url":"https://api.github.com/repos/guardian/service/pulls/comments/30789355","id":30789355,"diff_hunk":"@@ -0,0 +1,51 @@\n+HTTP\n+====\n+\n+## Resources\n+\n+Each EC2 instance MUST present the following (GET) resources:\n+\n+    [/service/healthcheck](#healthcheck)\n+    [/service/gtg](#gtg)\n+    [/service/dependencies](#dependencies)\n+\n+These resources should be presented on port 8080 (not port 80).","path":"spec/http.md","position":12,"original_position":12,"commit_id":"694fdc13855401c0533f8d90ed50838f4bb89efc","original_commit_id":"694fdc13855401c0533f8d90ed50838f4bb89efc","user":{"login":"cb372","id":106760,"avatar_url":"https://avatars.githubusercontent.com/u/106760?v=3","gravatar_id":"","url":"https://api.github.com/users/cb372","html_url":"https://github.com/cb372","followers_url":"https://api.github.com/users/cb372/followers","following_url":"https://api.github.com/users/cb372/following{/other_user}","gists_url":"https://api.github.com/users/cb372/gists{/gist_id}","starred_url":"https://api.github.com/users/cb372/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cb372/subscriptions","organizations_url":"https://api.github.com/users/cb372/orgs","repos_url":"https://api.github.com/users/cb372/repos","events_url":"https://api.github.com/users/cb372/events{/privacy}","received_events_url":"https://api.github.com/users/cb372/received_events","type":"User","site_admin":false},"body":"Definitely not port 80, as that implies root permissions, nginx, and all kinds of hassle.\r\n\r\nIs this implicitly saying that the service should expose its HTTP API on port 8080 and the management interface should be on the same port as that? If so, I would explicitly state both things, but make both of them SHOULD rather than MUST.","created_at":"2015-05-21T10:18:31Z","updated_at":"2015-05-21T10:18:31Z","html_url":"https://github.com/guardian/service/pull/3#discussion_r30789355","pull_request_url":"https://api.github.com/repos/guardian/service/pulls/3","_links":{"self":{"href":"https://api.github.com/repos/guardian/service/pulls/comments/30789355"},"html":{"href":"https://github.com/guardian/service/pull/3#discussion_r30789355"},"pull_request":{"href":"https://api.github.com/repos/guardian/service/pulls/3"}}},"pull_request":{"url":"https://api.github.com/repos/guardian/service/pulls/3","id":35914026,"html_url":"https://github.com/guardian/service/pull/3","diff_url":"https://github.com/guardian/service/pull/3.diff","patch_url":"https://github.com/guardian/service/pull/3.patch","issue_url":"https://api.github.com/repos/guardian/service/issues/3","number":3,"state":"open","locked":false,"title":"Add version 0.1.0","user":{"login":"nicl","id":858402,"avatar_url":"https://avatars.githubusercontent.com/u/858402?v=3","gravatar_id":"","url":"https://api.github.com/users/nicl","html_url":"https://github.com/nicl","followers_url":"https://api.github.com/users/nicl/followers","following_url":"https://api.github.com/users/nicl/following{/other_user}","gists_url":"https://api.github.com/users/nicl/gists{/gist_id}","starred_url":"https://api.github.com/users/nicl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/nicl/subscriptions","organizations_url":"https://api.github.com/users/nicl/orgs","repos_url":"https://api.github.com/users/nicl/repos","events_url":"https://api.github.com/users/nicl/events{/privacy}","received_events_url":"https://api.github.com/users/nicl/received_events","type":"User","site_admin":false},"body":"A fuller service description.","created_at":"2015-05-21T09:15:11Z","updated_at":"2015-05-21T10:18:31Z","closed_at":null,"merged_at":null,"merge_commit_sha":"db85b93c87521967201aa210dd75c20bf4e1dc12","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/guardian/service/pulls/3/commits","review_comments_url":"https://api.github.com/repos/guardian/service/pulls/3/comments","review_comment_url":"https://api.github.com/repos/guardian/service/pulls/comments{/number}","comments_url":"https://api.github.com/repos/guardian/service/issues/3/comments","statuses_url":"https://api.github.com/repos/guardian/service/statuses/694fdc13855401c0533f8d90ed50838f4bb89efc","head":{"label":"guardian:nl-add-note-on-api-formats","ref":"nl-add-note-on-api-formats","sha":"694fdc13855401c0533f8d90ed50838f4bb89efc","user":{"login":"guardian","id":164318,"avatar_url":"https://avatars.githubusercontent.com/u/164318?v=3","gravatar_id":"","url":"https://api.github.com/users/guardian","html_url":"https://github.com/guardian","followers_url":"https://api.github.com/users/guardian/followers","following_url":"https://api.github.com/users/guardian/following{/other_user}","gists_url":"https://api.github.com/users/guardian/gists{/gist_id}","starred_url":"https://api.github.com/users/guardian/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/guardian/subscriptions","organizations_url":"https://api.github.com/users/guardian/orgs","repos_url":"https://api.github.com/users/guardian/repos","events_url":"https://api.github.com/users/guardian/events{/privacy}","received_events_url":"https://api.github.com/users/guardian/received_events","type":"Organization","site_admin":false},"repo":{"id":24197066,"name":"service","full_name":"guardian/service","owner":{"login":"guardian","id":164318,"avatar_url":"https://avatars.githubusercontent.com/u/164318?v=3","gravatar_id":"","url":"https://api.github.com/users/guardian","html_url":"https://github.com/guardian","followers_url":"https://api.github.com/users/guardian/followers","following_url":"https://api.github.com/users/guardian/following{/other_user}","gists_url":"https://api.github.com/users/guardian/gists{/gist_id}","starred_url":"https://api.github.com/users/guardian/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/guardian/subscriptions","organizations_url":"https://api.github.com/users/guardian/orgs","repos_url":"https://api.github.com/users/guardian/repos","events_url":"https://api.github.com/users/guardian/events{/privacy}","received_events_url":"https://api.github.com/users/guardian/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/guardian/service","description":"Defines a Service abstraction for apps in the cloud.","fork":false,"url":"https://api.github.com/repos/guardian/service","forks_url":"https://api.github.com/repos/guardian/service/forks","keys_url":"https://api.github.com/repos/guardian/service/keys{/key_id}","collaborators_url":"https://api.github.com/repos/guardian/service/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/guardian/service/teams","hooks_url":"https://api.github.com/repos/guardian/service/hooks","issue_events_url":"https://api.github.com/repos/guardian/service/issues/events{/number}","events_url":"https://api.github.com/repos/guardian/service/events","assignees_url":"https://api.github.com/repos/guardian/service/assignees{/user}","branches_url":"https://api.github.com/repos/guardian/service/branches{/branch}","tags_url":"https://api.github.com/repos/guardian/service/tags","blobs_url":"https://api.github.com/repos/guardian/service/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/guardian/service/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/guardian/service/git/refs{/sha}","trees_url":"https://api.github.com/repos/guardian/service/git/trees{/sha}","statuses_url":"https://api.github.com/repos/guardian/service/statuses/{sha}","languages_url":"https://api.github.com/repos/guardian/service/languages","stargazers_url":"https://api.github.com/repos/guardian/service/stargazers","contributors_url":"https://api.github.com/repos/guardian/service/contributors","subscribers_url":"https://api.github.com/repos/guardian/service/subscribers","subscription_url":"https://api.github.com/repos/guardian/service/subscription","commits_url":"https://api.github.com/repos/guardian/service/commits{/sha}","git_commits_url":"https://api.github.com/repos/guardian/service/git/commits{/sha}","comments_url":"https://api.github.com/repos/guardian/service/comments{/number}","issue_comment_url":"https://api.github.com/repos/guardian/service/issues/comments{/number}","contents_url":"https://api.github.com/repos/guardian/service/contents/{+path}","compare_url":"https://api.github.com/repos/guardian/service/compare/{base}...{head}","merges_url":"https://api.github.com/repos/guardian/service/merges","archive_url":"https://api.github.com/repos/guardian/service/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/guardian/service/downloads","issues_url":"https://api.github.com/repos/guardian/service/issues{/number}","pulls_url":"https://api.github.com/repos/guardian/service/pulls{/number}","milestones_url":"https://api.github.com/repos/guardian/service/milestones{/number}","notifications_url":"https://api.github.com/repos/guardian/service/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/guardian/service/labels{/name}","releases_url":"https://api.github.com/repos/guardian/service/releases{/id}","created_at":"2014-09-18T17:02:17Z","updated_at":"2015-02-25T16:28:45Z","pushed_at":"2015-05-21T09:15:47Z","git_url":"git://github.com/guardian/service.git","ssh_url":"git@github.com:guardian/service.git","clone_url":"https://github.com/guardian/service.git","svn_url":"https://github.com/guardian/service","homepage":null,"size":210,"stargazers_count":2,"watchers_count":2,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":3,"forks":1,"open_issues":3,"watchers":2,"default_branch":"master"}},"base":{"label":"guardian:master","ref":"master","sha":"093c447bcd5bec3ec69e858a74b0d9f402582965","user":{"login":"guardian","id":164318,"avatar_url":"https://avatars.githubusercontent.com/u/164318?v=3","gravatar_id":"","url":"https://api.github.com/users/guardian","html_url":"https://github.com/guardian","followers_url":"https://api.github.com/users/guardian/followers","following_url":"https://api.github.com/users/guardian/following{/other_user}","gists_url":"https://api.github.com/users/guardian/gists{/gist_id}","starred_url":"https://api.github.com/users/guardian/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/guardian/subscriptions","organizations_url":"https://api.github.com/users/guardian/orgs","repos_url":"https://api.github.com/users/guardian/repos","events_url":"https://api.github.com/users/guardian/events{/privacy}","received_events_url":"https://api.github.com/users/guardian/received_events","type":"Organization","site_admin":false},"repo":{"id":24197066,"name":"service","full_name":"guardian/service","owner":{"login":"guardian","id":164318,"avatar_url":"https://avatars.githubusercontent.com/u/164318?v=3","gravatar_id":"","url":"https://api.github.com/users/guardian","html_url":"https://github.com/guardian","followers_url":"https://api.github.com/users/guardian/followers","following_url":"https://api.github.com/users/guardian/following{/other_user}","gists_url":"https://api.github.com/users/guardian/gists{/gist_id}","starred_url":"https://api.github.com/users/guardian/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/guardian/subscriptions","organizations_url":"https://api.github.com/users/guardian/orgs","repos_url":"https://api.github.com/users/guardian/repos","events_url":"https://api.github.com/users/guardian/events{/privacy}","received_events_url":"https://api.github.com/users/guardian/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/guardian/service","description":"Defines a Service abstraction for apps in the cloud.","fork":false,"url":"https://api.github.com/repos/guardian/service","forks_url":"https://api.github.com/repos/guardian/service/forks","keys_url":"https://api.github.com/repos/guardian/service/keys{/key_id}","collaborators_url":"https://api.github.com/repos/guardian/service/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/guardian/service/teams","hooks_url":"https://api.github.com/repos/guardian/service/hooks","issue_events_url":"https://api.github.com/repos/guardian/service/issues/events{/number}","events_url":"https://api.github.com/repos/guardian/service/events","assignees_url":"https://api.github.com/repos/guardian/service/assignees{/user}","branches_url":"https://api.github.com/repos/guardian/service/branches{/branch}","tags_url":"https://api.github.com/repos/guardian/service/tags","blobs_url":"https://api.github.com/repos/guardian/service/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/guardian/service/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/guardian/service/git/refs{/sha}","trees_url":"https://api.github.com/repos/guardian/service/git/trees{/sha}","statuses_url":"https://api.github.com/repos/guardian/service/statuses/{sha}","languages_url":"https://api.github.com/repos/guardian/service/languages","stargazers_url":"https://api.github.com/repos/guardian/service/stargazers","contributors_url":"https://api.github.com/repos/guardian/service/contributors","subscribers_url":"https://api.github.com/repos/guardian/service/subscribers","subscription_url":"https://api.github.com/repos/guardian/service/subscription","commits_url":"https://api.github.com/repos/guardian/service/commits{/sha}","git_commits_url":"https://api.github.com/repos/guardian/service/git/commits{/sha}","comments_url":"https://api.github.com/repos/guardian/service/comments{/number}","issue_comment_url":"https://api.github.com/repos/guardian/service/issues/comments{/number}","contents_url":"https://api.github.com/repos/guardian/service/contents/{+path}","compare_url":"https://api.github.com/repos/guardian/service/compare/{base}...{head}","merges_url":"https://api.github.com/repos/guardian/service/merges","archive_url":"https://api.github.com/repos/guardian/service/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/guardian/service/downloads","issues_url":"https://api.github.com/repos/guardian/service/issues{/number}","pulls_url":"https://api.github.com/repos/guardian/service/pulls{/number}","milestones_url":"https://api.github.com/repos/guardian/service/milestones{/number}","notifications_url":"https://api.github.com/repos/guardian/service/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/guardian/service/labels{/name}","releases_url":"https://api.github.com/repos/guardian/service/releases{/id}","created_at":"2014-09-18T17:02:17Z","updated_at":"2015-02-25T16:28:45Z","pushed_at":"2015-05-21T09:15:47Z","git_url":"git://github.com/guardian/service.git","ssh_url":"git@github.com:guardian/service.git","clone_url":"https://github.com/guardian/service.git","svn_url":"https://github.com/guardian/service","homepage":null,"size":210,"stargazers_count":2,"watchers_count":2,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":3,"forks":1,"open_issues":3,"watchers":2,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/guardian/service/pulls/3"},"html":{"href":"https://github.com/guardian/service/pull/3"},"issue":{"href":"https://api.github.com/repos/guardian/service/issues/3"},"comments":{"href":"https://api.github.com/repos/guardian/service/issues/3/comments"},"review_comments":{"href":"https://api.github.com/repos/guardian/service/pulls/3/comments"},"review_comment":{"href":"https://api.github.com/repos/guardian/service/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/guardian/service/pulls/3/commits"},"statuses":{"href":"https://api.github.com/repos/guardian/service/statuses/694fdc13855401c0533f8d90ed50838f4bb89efc"}}}}