{"action":"created","comment":{"url":"https://api.github.com/repos/heroku/busl/pulls/comments/30752119","id":30752119,"diff_hunk":"@@ -0,0 +1,39 @@\n+# publisher reconnects brainstorm\n+\n+In order to make the service 100% more reliable, we need\n+to add reconnects to busl.\n+\n+The following is a draft of the protocol specification:\n+\n+## Clients\n+\n+1. Clients keep track of the byte offsets, and send them\n+   as `Content-Range: byte=x-y` headers\n+2. The client decides how much to buffer, and/or how frequently\n+   should the posts happen.\n+3. For every chunk that should be sent, the client sends to\n+   a new endpoint, which is tentatively defined as `PATCH /streams/<id>`\n+4. The client will then have to confirm the `ACK` from the server,","path":"docs/reconnects.md","position":16,"original_position":16,"commit_id":"05e6a491474438b10d6bd8e8cb48c73f7d197774","original_commit_id":"05e6a491474438b10d6bd8e8cb48c73f7d197774","user":{"login":"ojacobson","id":160985,"avatar_url":"https://avatars.githubusercontent.com/u/160985?v=3","gravatar_id":"","url":"https://api.github.com/users/ojacobson","html_url":"https://github.com/ojacobson","followers_url":"https://api.github.com/users/ojacobson/followers","following_url":"https://api.github.com/users/ojacobson/following{/other_user}","gists_url":"https://api.github.com/users/ojacobson/gists{/gist_id}","starred_url":"https://api.github.com/users/ojacobson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ojacobson/subscriptions","organizations_url":"https://api.github.com/users/ojacobson/orgs","repos_url":"https://api.github.com/users/ojacobson/repos","events_url":"https://api.github.com/users/ojacobson/events{/privacy}","received_events_url":"https://api.github.com/users/ojacobson/received_events","type":"User","site_admin":false},"body":"Is the `ACK` distinct from a 2xx-series response? (`No Content`, perhaps?)","created_at":"2015-05-20T21:35:35Z","updated_at":"2015-05-20T21:35:35Z","html_url":"https://github.com/heroku/busl/pull/50#discussion_r30752119","pull_request_url":"https://api.github.com/repos/heroku/busl/pulls/50","_links":{"self":{"href":"https://api.github.com/repos/heroku/busl/pulls/comments/30752119"},"html":{"href":"https://github.com/heroku/busl/pull/50#discussion_r30752119"},"pull_request":{"href":"https://api.github.com/repos/heroku/busl/pulls/50"}}},"pull_request":{"url":"https://api.github.com/repos/heroku/busl/pulls/50","id":35073017,"html_url":"https://github.com/heroku/busl/pull/50","diff_url":"https://github.com/heroku/busl/pull/50.diff","patch_url":"https://github.com/heroku/busl/pull/50.patch","issue_url":"https://api.github.com/repos/heroku/busl/issues/50","number":50,"state":"open","locked":false,"title":"Draft specification for publisher reconnects","user":{"login":"cyx","id":2257,"avatar_url":"https://avatars.githubusercontent.com/u/2257?v=3","gravatar_id":"","url":"https://api.github.com/users/cyx","html_url":"https://github.com/cyx","followers_url":"https://api.github.com/users/cyx/followers","following_url":"https://api.github.com/users/cyx/following{/other_user}","gists_url":"https://api.github.com/users/cyx/gists{/gist_id}","starred_url":"https://api.github.com/users/cyx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cyx/subscriptions","organizations_url":"https://api.github.com/users/cyx/orgs","repos_url":"https://api.github.com/users/cyx/repos","events_url":"https://api.github.com/users/cyx/events{/privacy}","received_events_url":"https://api.github.com/users/cyx/received_events","type":"User","site_admin":false},"body":"Draft specification, feel free to scrutinize as much as you can.","created_at":"2015-05-09T21:13:51Z","updated_at":"2015-05-20T21:35:35Z","closed_at":null,"merged_at":null,"merge_commit_sha":"4f5585116b38e71587af02538bfbf74961222579","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/heroku/busl/pulls/50/commits","review_comments_url":"https://api.github.com/repos/heroku/busl/pulls/50/comments","review_comment_url":"https://api.github.com/repos/heroku/busl/pulls/comments{/number}","comments_url":"https://api.github.com/repos/heroku/busl/issues/50/comments","statuses_url":"https://api.github.com/repos/heroku/busl/statuses/05e6a491474438b10d6bd8e8cb48c73f7d197774","head":{"label":"heroku:reconnects","ref":"reconnects","sha":"05e6a491474438b10d6bd8e8cb48c73f7d197774","user":{"login":"heroku","id":23211,"avatar_url":"https://avatars.githubusercontent.com/u/23211?v=3","gravatar_id":"","url":"https://api.github.com/users/heroku","html_url":"https://github.com/heroku","followers_url":"https://api.github.com/users/heroku/followers","following_url":"https://api.github.com/users/heroku/following{/other_user}","gists_url":"https://api.github.com/users/heroku/gists{/gist_id}","starred_url":"https://api.github.com/users/heroku/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/heroku/subscriptions","organizations_url":"https://api.github.com/users/heroku/orgs","repos_url":"https://api.github.com/users/heroku/repos","events_url":"https://api.github.com/users/heroku/events{/privacy}","received_events_url":"https://api.github.com/users/heroku/received_events","type":"Organization","site_admin":false},"repo":{"id":20514785,"name":"busl","full_name":"heroku/busl","owner":{"login":"heroku","id":23211,"avatar_url":"https://avatars.githubusercontent.com/u/23211?v=3","gravatar_id":"","url":"https://api.github.com/users/heroku","html_url":"https://github.com/heroku","followers_url":"https://api.github.com/users/heroku/followers","following_url":"https://api.github.com/users/heroku/following{/other_user}","gists_url":"https://api.github.com/users/heroku/gists{/gist_id}","starred_url":"https://api.github.com/users/heroku/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/heroku/subscriptions","organizations_url":"https://api.github.com/users/heroku/orgs","repos_url":"https://api.github.com/users/heroku/repos","events_url":"https://api.github.com/users/heroku/events{/privacy}","received_events_url":"https://api.github.com/users/heroku/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/heroku/busl","description":"a simple pubsub service that runs on Heroku","fork":false,"url":"https://api.github.com/repos/heroku/busl","forks_url":"https://api.github.com/repos/heroku/busl/forks","keys_url":"https://api.github.com/repos/heroku/busl/keys{/key_id}","collaborators_url":"https://api.github.com/repos/heroku/busl/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/heroku/busl/teams","hooks_url":"https://api.github.com/repos/heroku/busl/hooks","issue_events_url":"https://api.github.com/repos/heroku/busl/issues/events{/number}","events_url":"https://api.github.com/repos/heroku/busl/events","assignees_url":"https://api.github.com/repos/heroku/busl/assignees{/user}","branches_url":"https://api.github.com/repos/heroku/busl/branches{/branch}","tags_url":"https://api.github.com/repos/heroku/busl/tags","blobs_url":"https://api.github.com/repos/heroku/busl/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/heroku/busl/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/heroku/busl/git/refs{/sha}","trees_url":"https://api.github.com/repos/heroku/busl/git/trees{/sha}","statuses_url":"https://api.github.com/repos/heroku/busl/statuses/{sha}","languages_url":"https://api.github.com/repos/heroku/busl/languages","stargazers_url":"https://api.github.com/repos/heroku/busl/stargazers","contributors_url":"https://api.github.com/repos/heroku/busl/contributors","subscribers_url":"https://api.github.com/repos/heroku/busl/subscribers","subscription_url":"https://api.github.com/repos/heroku/busl/subscription","commits_url":"https://api.github.com/repos/heroku/busl/commits{/sha}","git_commits_url":"https://api.github.com/repos/heroku/busl/git/commits{/sha}","comments_url":"https://api.github.com/repos/heroku/busl/comments{/number}","issue_comment_url":"https://api.github.com/repos/heroku/busl/issues/comments{/number}","contents_url":"https://api.github.com/repos/heroku/busl/contents/{+path}","compare_url":"https://api.github.com/repos/heroku/busl/compare/{base}...{head}","merges_url":"https://api.github.com/repos/heroku/busl/merges","archive_url":"https://api.github.com/repos/heroku/busl/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/heroku/busl/downloads","issues_url":"https://api.github.com/repos/heroku/busl/issues{/number}","pulls_url":"https://api.github.com/repos/heroku/busl/pulls{/number}","milestones_url":"https://api.github.com/repos/heroku/busl/milestones{/number}","notifications_url":"https://api.github.com/repos/heroku/busl/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/heroku/busl/labels{/name}","releases_url":"https://api.github.com/repos/heroku/busl/releases{/id}","created_at":"2014-06-05T06:47:54Z","updated_at":"2015-05-07T06:21:46Z","pushed_at":"2015-05-20T21:27:02Z","git_url":"git://github.com/heroku/busl.git","ssh_url":"git@github.com:heroku/busl.git","clone_url":"https://github.com/heroku/busl.git","svn_url":"https://github.com/heroku/busl","homepage":"","size":2456,"stargazers_count":19,"watchers_count":19,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":4,"mirror_url":null,"open_issues_count":4,"forks":4,"open_issues":4,"watchers":19,"default_branch":"master"}},"base":{"label":"heroku:master","ref":"master","sha":"674762000ee449289e329334718a82903131caf8","user":{"login":"heroku","id":23211,"avatar_url":"https://avatars.githubusercontent.com/u/23211?v=3","gravatar_id":"","url":"https://api.github.com/users/heroku","html_url":"https://github.com/heroku","followers_url":"https://api.github.com/users/heroku/followers","following_url":"https://api.github.com/users/heroku/following{/other_user}","gists_url":"https://api.github.com/users/heroku/gists{/gist_id}","starred_url":"https://api.github.com/users/heroku/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/heroku/subscriptions","organizations_url":"https://api.github.com/users/heroku/orgs","repos_url":"https://api.github.com/users/heroku/repos","events_url":"https://api.github.com/users/heroku/events{/privacy}","received_events_url":"https://api.github.com/users/heroku/received_events","type":"Organization","site_admin":false},"repo":{"id":20514785,"name":"busl","full_name":"heroku/busl","owner":{"login":"heroku","id":23211,"avatar_url":"https://avatars.githubusercontent.com/u/23211?v=3","gravatar_id":"","url":"https://api.github.com/users/heroku","html_url":"https://github.com/heroku","followers_url":"https://api.github.com/users/heroku/followers","following_url":"https://api.github.com/users/heroku/following{/other_user}","gists_url":"https://api.github.com/users/heroku/gists{/gist_id}","starred_url":"https://api.github.com/users/heroku/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/heroku/subscriptions","organizations_url":"https://api.github.com/users/heroku/orgs","repos_url":"https://api.github.com/users/heroku/repos","events_url":"https://api.github.com/users/heroku/events{/privacy}","received_events_url":"https://api.github.com/users/heroku/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/heroku/busl","description":"a simple pubsub service that runs on Heroku","fork":false,"url":"https://api.github.com/repos/heroku/busl","forks_url":"https://api.github.com/repos/heroku/busl/forks","keys_url":"https://api.github.com/repos/heroku/busl/keys{/key_id}","collaborators_url":"https://api.github.com/repos/heroku/busl/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/heroku/busl/teams","hooks_url":"https://api.github.com/repos/heroku/busl/hooks","issue_events_url":"https://api.github.com/repos/heroku/busl/issues/events{/number}","events_url":"https://api.github.com/repos/heroku/busl/events","assignees_url":"https://api.github.com/repos/heroku/busl/assignees{/user}","branches_url":"https://api.github.com/repos/heroku/busl/branches{/branch}","tags_url":"https://api.github.com/repos/heroku/busl/tags","blobs_url":"https://api.github.com/repos/heroku/busl/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/heroku/busl/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/heroku/busl/git/refs{/sha}","trees_url":"https://api.github.com/repos/heroku/busl/git/trees{/sha}","statuses_url":"https://api.github.com/repos/heroku/busl/statuses/{sha}","languages_url":"https://api.github.com/repos/heroku/busl/languages","stargazers_url":"https://api.github.com/repos/heroku/busl/stargazers","contributors_url":"https://api.github.com/repos/heroku/busl/contributors","subscribers_url":"https://api.github.com/repos/heroku/busl/subscribers","subscription_url":"https://api.github.com/repos/heroku/busl/subscription","commits_url":"https://api.github.com/repos/heroku/busl/commits{/sha}","git_commits_url":"https://api.github.com/repos/heroku/busl/git/commits{/sha}","comments_url":"https://api.github.com/repos/heroku/busl/comments{/number}","issue_comment_url":"https://api.github.com/repos/heroku/busl/issues/comments{/number}","contents_url":"https://api.github.com/repos/heroku/busl/contents/{+path}","compare_url":"https://api.github.com/repos/heroku/busl/compare/{base}...{head}","merges_url":"https://api.github.com/repos/heroku/busl/merges","archive_url":"https://api.github.com/repos/heroku/busl/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/heroku/busl/downloads","issues_url":"https://api.github.com/repos/heroku/busl/issues{/number}","pulls_url":"https://api.github.com/repos/heroku/busl/pulls{/number}","milestones_url":"https://api.github.com/repos/heroku/busl/milestones{/number}","notifications_url":"https://api.github.com/repos/heroku/busl/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/heroku/busl/labels{/name}","releases_url":"https://api.github.com/repos/heroku/busl/releases{/id}","created_at":"2014-06-05T06:47:54Z","updated_at":"2015-05-07T06:21:46Z","pushed_at":"2015-05-20T21:27:02Z","git_url":"git://github.com/heroku/busl.git","ssh_url":"git@github.com:heroku/busl.git","clone_url":"https://github.com/heroku/busl.git","svn_url":"https://github.com/heroku/busl","homepage":"","size":2456,"stargazers_count":19,"watchers_count":19,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":4,"mirror_url":null,"open_issues_count":4,"forks":4,"open_issues":4,"watchers":19,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/heroku/busl/pulls/50"},"html":{"href":"https://github.com/heroku/busl/pull/50"},"issue":{"href":"https://api.github.com/repos/heroku/busl/issues/50"},"comments":{"href":"https://api.github.com/repos/heroku/busl/issues/50/comments"},"review_comments":{"href":"https://api.github.com/repos/heroku/busl/pulls/50/comments"},"review_comment":{"href":"https://api.github.com/repos/heroku/busl/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/heroku/busl/pulls/50/commits"},"statuses":{"href":"https://api.github.com/repos/heroku/busl/statuses/05e6a491474438b10d6bd8e8cb48c73f7d197774"}}}}