{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker.github.io/pulls/comments/86675078","pull_request_review_id":7323309,"id":86675078,"diff_hunk":"@@ -8,29 +8,30 @@ keywords:\n title: Breaking changes and incompatibilities\n ---\n \n-Every Engine release strives to be backward compatible with its predecessors.\n-In all cases, the policy is that feature removal is communicated two releases\n+Every Engine release strives to be backward compatible with its predecessors,\n+and interface stability is always a priority at Docker.\n+\n+In all cases, feature removal is communicated two releases\n in advance and documented as part of the [deprecated features](deprecated.md)\n page.\n+  \n+The following list compiles any updates to Docker Engine that created\n+backwards-incompatibility for old versions of Docker tools.\n \n-Unfortunately, Docker is a fast moving project, and newly introduced features\n-may sometime introduce breaking changes and/or incompatibilities. This page\n-documents these by Engine version.\n-\n-# Engine 1.12\n-\n-Docker clients <= 1.9.2 used an invalid Host header when making request to the\n-daemon. Docker 1.12 is built using golang 1.6 which is now checking the validity\n-of the Host header and as such clients <= 1.9.2 can't talk anymore to the daemon.\n-[An environment variable was added to overcome this issue.](reference/commandline/dockerd.md#miscellaneous-options)\n+> Note: In the case of your local environment, you should be updating your\n+  Docker Engine using [Docker for Mac](/docker-for-mac),\n+  [Docker for Windows](/docker-for-windows),\n+  or, in the case of Linux, [Docker Toolbox](/toolbox). That way all your","path":"engine/breaking_changes.md","position":29,"original_position":29,"commit_id":"6d700fcfacf22920e28dbc2181561ce05ac5a445","original_commit_id":"6d700fcfacf22920e28dbc2181561ce05ac5a445","user":{"login":"thaJeztah","id":1804568,"avatar_url":"https://avatars.githubusercontent.com/u/1804568?v=3","gravatar_id":"","url":"https://api.github.com/users/thaJeztah","html_url":"https://github.com/thaJeztah","followers_url":"https://api.github.com/users/thaJeztah/followers","following_url":"https://api.github.com/users/thaJeztah/following{/other_user}","gists_url":"https://api.github.com/users/thaJeztah/gists{/gist_id}","starred_url":"https://api.github.com/users/thaJeztah/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thaJeztah/subscriptions","organizations_url":"https://api.github.com/users/thaJeztah/orgs","repos_url":"https://api.github.com/users/thaJeztah/repos","events_url":"https://api.github.com/users/thaJeztah/events{/privacy}","received_events_url":"https://api.github.com/users/thaJeztah/received_events","type":"User","site_admin":false},"body":"we shouldn't recommend docker toolbox for linux ","created_at":"2016-11-05T23:07:43Z","updated_at":"2016-11-05T23:08:58Z","html_url":"https://github.com/docker/docker.github.io/pull/473#discussion_r86675078","pull_request_url":"https://api.github.com/repos/docker/docker.github.io/pulls/473","_links":{"self":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/comments/86675078"},"html":{"href":"https://github.com/docker/docker.github.io/pull/473#discussion_r86675078"},"pull_request":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/473"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker.github.io/pulls/473","id":92469008,"html_url":"https://github.com/docker/docker.github.io/pull/473","diff_url":"https://github.com/docker/docker.github.io/pull/473.diff","patch_url":"https://github.com/docker/docker.github.io/pull/473.patch","issue_url":"https://api.github.com/repos/docker/docker.github.io/issues/473","number":473,"state":"open","locked":false,"title":"Reword and reformat \"Breaking changes\" page","user":{"login":"johndmulhausen","id":5439615,"avatar_url":"https://avatars.githubusercontent.com/u/5439615?v=3","gravatar_id":"","url":"https://api.github.com/users/johndmulhausen","html_url":"https://github.com/johndmulhausen","followers_url":"https://api.github.com/users/johndmulhausen/followers","following_url":"https://api.github.com/users/johndmulhausen/following{/other_user}","gists_url":"https://api.github.com/users/johndmulhausen/gists{/gist_id}","starred_url":"https://api.github.com/users/johndmulhausen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/johndmulhausen/subscriptions","organizations_url":"https://api.github.com/users/johndmulhausen/orgs","repos_url":"https://api.github.com/users/johndmulhausen/repos","events_url":"https://api.github.com/users/johndmulhausen/events{/privacy}","received_events_url":"https://api.github.com/users/johndmulhausen/received_events","type":"User","site_admin":false},"body":"Reformat so that it's more clear that the two issues under v1.10 belong to that release.","created_at":"2016-11-05T22:07:06Z","updated_at":"2016-11-05T23:08:58Z","closed_at":null,"merged_at":null,"merge_commit_sha":"5a306ed43fa498887312c2713b70989d0711b207","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/docker/docker.github.io/pulls/473/commits","review_comments_url":"https://api.github.com/repos/docker/docker.github.io/pulls/473/comments","review_comment_url":"https://api.github.com/repos/docker/docker.github.io/pulls/comments{/number}","comments_url":"https://api.github.com/repos/docker/docker.github.io/issues/473/comments","statuses_url":"https://api.github.com/repos/docker/docker.github.io/statuses/6d700fcfacf22920e28dbc2181561ce05ac5a445","head":{"label":"docker:incompatibility-e","ref":"incompatibility-e","sha":"6d700fcfacf22920e28dbc2181561ce05ac5a445","user":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"repo":{"id":65772720,"name":"docker.github.io","full_name":"docker/docker.github.io","owner":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/docker/docker.github.io","description":"Source repo for Docker's Documentation","fork":false,"url":"https://api.github.com/repos/docker/docker.github.io","forks_url":"https://api.github.com/repos/docker/docker.github.io/forks","keys_url":"https://api.github.com/repos/docker/docker.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/docker/docker.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/docker/docker.github.io/teams","hooks_url":"https://api.github.com/repos/docker/docker.github.io/hooks","issue_events_url":"https://api.github.com/repos/docker/docker.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/docker/docker.github.io/events","assignees_url":"https://api.github.com/repos/docker/docker.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/docker/docker.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/docker/docker.github.io/tags","blobs_url":"https://api.github.com/repos/docker/docker.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/docker/docker.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/docker/docker.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/docker/docker.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/docker/docker.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/docker/docker.github.io/languages","stargazers_url":"https://api.github.com/repos/docker/docker.github.io/stargazers","contributors_url":"https://api.github.com/repos/docker/docker.github.io/contributors","subscribers_url":"https://api.github.com/repos/docker/docker.github.io/subscribers","subscription_url":"https://api.github.com/repos/docker/docker.github.io/subscription","commits_url":"https://api.github.com/repos/docker/docker.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/docker/docker.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/docker/docker.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/docker/docker.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/docker/docker.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/docker/docker.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/docker/docker.github.io/merges","archive_url":"https://api.github.com/repos/docker/docker.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/docker/docker.github.io/downloads","issues_url":"https://api.github.com/repos/docker/docker.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/docker/docker.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/docker/docker.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/docker/docker.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/docker/docker.github.io/labels{/name}","releases_url":"https://api.github.com/repos/docker/docker.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/docker/docker.github.io/deployments","created_at":"2016-08-15T23:50:51Z","updated_at":"2016-11-05T23:00:59Z","pushed_at":"2016-11-05T22:48:04Z","git_url":"git://github.com/docker/docker.github.io.git","ssh_url":"git@github.com:docker/docker.github.io.git","clone_url":"https://github.com/docker/docker.github.io.git","svn_url":"https://github.com/docker/docker.github.io","homepage":"https://docs.docker.com","size":355050,"stargazers_count":73,"watchers_count":73,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":235,"mirror_url":null,"open_issues_count":81,"forks":235,"open_issues":81,"watchers":73,"default_branch":"master"}},"base":{"label":"docker:master","ref":"master","sha":"7a4f6f0120813bad2cfe49dbc6b155bf03a3cdee","user":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"repo":{"id":65772720,"name":"docker.github.io","full_name":"docker/docker.github.io","owner":{"login":"docker","id":5429470,"avatar_url":"https://avatars.githubusercontent.com/u/5429470?v=3","gravatar_id":"","url":"https://api.github.com/users/docker","html_url":"https://github.com/docker","followers_url":"https://api.github.com/users/docker/followers","following_url":"https://api.github.com/users/docker/following{/other_user}","gists_url":"https://api.github.com/users/docker/gists{/gist_id}","starred_url":"https://api.github.com/users/docker/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/docker/subscriptions","organizations_url":"https://api.github.com/users/docker/orgs","repos_url":"https://api.github.com/users/docker/repos","events_url":"https://api.github.com/users/docker/events{/privacy}","received_events_url":"https://api.github.com/users/docker/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/docker/docker.github.io","description":"Source repo for Docker's Documentation","fork":false,"url":"https://api.github.com/repos/docker/docker.github.io","forks_url":"https://api.github.com/repos/docker/docker.github.io/forks","keys_url":"https://api.github.com/repos/docker/docker.github.io/keys{/key_id}","collaborators_url":"https://api.github.com/repos/docker/docker.github.io/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/docker/docker.github.io/teams","hooks_url":"https://api.github.com/repos/docker/docker.github.io/hooks","issue_events_url":"https://api.github.com/repos/docker/docker.github.io/issues/events{/number}","events_url":"https://api.github.com/repos/docker/docker.github.io/events","assignees_url":"https://api.github.com/repos/docker/docker.github.io/assignees{/user}","branches_url":"https://api.github.com/repos/docker/docker.github.io/branches{/branch}","tags_url":"https://api.github.com/repos/docker/docker.github.io/tags","blobs_url":"https://api.github.com/repos/docker/docker.github.io/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/docker/docker.github.io/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/docker/docker.github.io/git/refs{/sha}","trees_url":"https://api.github.com/repos/docker/docker.github.io/git/trees{/sha}","statuses_url":"https://api.github.com/repos/docker/docker.github.io/statuses/{sha}","languages_url":"https://api.github.com/repos/docker/docker.github.io/languages","stargazers_url":"https://api.github.com/repos/docker/docker.github.io/stargazers","contributors_url":"https://api.github.com/repos/docker/docker.github.io/contributors","subscribers_url":"https://api.github.com/repos/docker/docker.github.io/subscribers","subscription_url":"https://api.github.com/repos/docker/docker.github.io/subscription","commits_url":"https://api.github.com/repos/docker/docker.github.io/commits{/sha}","git_commits_url":"https://api.github.com/repos/docker/docker.github.io/git/commits{/sha}","comments_url":"https://api.github.com/repos/docker/docker.github.io/comments{/number}","issue_comment_url":"https://api.github.com/repos/docker/docker.github.io/issues/comments{/number}","contents_url":"https://api.github.com/repos/docker/docker.github.io/contents/{+path}","compare_url":"https://api.github.com/repos/docker/docker.github.io/compare/{base}...{head}","merges_url":"https://api.github.com/repos/docker/docker.github.io/merges","archive_url":"https://api.github.com/repos/docker/docker.github.io/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/docker/docker.github.io/downloads","issues_url":"https://api.github.com/repos/docker/docker.github.io/issues{/number}","pulls_url":"https://api.github.com/repos/docker/docker.github.io/pulls{/number}","milestones_url":"https://api.github.com/repos/docker/docker.github.io/milestones{/number}","notifications_url":"https://api.github.com/repos/docker/docker.github.io/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/docker/docker.github.io/labels{/name}","releases_url":"https://api.github.com/repos/docker/docker.github.io/releases{/id}","deployments_url":"https://api.github.com/repos/docker/docker.github.io/deployments","created_at":"2016-08-15T23:50:51Z","updated_at":"2016-11-05T23:00:59Z","pushed_at":"2016-11-05T22:48:04Z","git_url":"git://github.com/docker/docker.github.io.git","ssh_url":"git@github.com:docker/docker.github.io.git","clone_url":"https://github.com/docker/docker.github.io.git","svn_url":"https://github.com/docker/docker.github.io","homepage":"https://docs.docker.com","size":355050,"stargazers_count":73,"watchers_count":73,"language":"JavaScript","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":235,"mirror_url":null,"open_issues_count":81,"forks":235,"open_issues":81,"watchers":73,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/473"},"html":{"href":"https://github.com/docker/docker.github.io/pull/473"},"issue":{"href":"https://api.github.com/repos/docker/docker.github.io/issues/473"},"comments":{"href":"https://api.github.com/repos/docker/docker.github.io/issues/473/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/473/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/docker/docker.github.io/pulls/473/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker.github.io/statuses/6d700fcfacf22920e28dbc2181561ce05ac5a445"}}}}
{"actor":{"display_login":"thaJeztah"}}