{"action":"closed","issue":{"url":"https://api.github.com/repos/docker/docker/issues/14087","repository_url":"https://api.github.com/repos/docker/docker","labels_url":"https://api.github.com/repos/docker/docker/issues/14087/labels{/name}","comments_url":"https://api.github.com/repos/docker/docker/issues/14087/comments","events_url":"https://api.github.com/repos/docker/docker/issues/14087/events","html_url":"https://github.com/docker/docker/issues/14087","id":90022252,"number":14087,"title":"Docker documentation is contradictory regarding VolumesFrom","user":{"login":"vincentwoo","id":613320,"avatar_url":"https://avatars.githubusercontent.com/u/613320?v=3","gravatar_id":"","url":"https://api.github.com/users/vincentwoo","html_url":"https://github.com/vincentwoo","followers_url":"https://api.github.com/users/vincentwoo/followers","following_url":"https://api.github.com/users/vincentwoo/following{/other_user}","gists_url":"https://api.github.com/users/vincentwoo/gists{/gist_id}","starred_url":"https://api.github.com/users/vincentwoo/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vincentwoo/subscriptions","organizations_url":"https://api.github.com/users/vincentwoo/orgs","repos_url":"https://api.github.com/users/vincentwoo/repos","events_url":"https://api.github.com/users/vincentwoo/events{/privacy}","received_events_url":"https://api.github.com/users/vincentwoo/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/docker/docker/labels/area/docs","name":"area/docs","color":"fbca04"}],"state":"closed","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":3,"created_at":"2015-06-22T06:19:16Z","updated_at":"2016-09-15T13:50:56Z","closed_at":"2016-09-15T13:50:56Z","body":"Here is what you get when you search in the docker repo for the string `\"VolumesFrom\"`: https://github.com/docker/docker/search?utf8=%E2%9C%93&q=VolumesFrom\r\n\r\nThe issue is that most of the response formats ascribed to docker inspect say that the endpoint will return something like\r\n\r\n` \"VolumesFrom\":\"\"`\r\n\r\nThis is untrue - as of docker 1.7 (and probably much earlier), docker returns either `null` or something like `[\"contrainerid\"]` as the value for that key.\r\n\r\nThe tricky part is that early docker (1.0) used to accept a string as input for `VolumesFrom` in the remote api, before a change (maybe around 1.4?) had it take an array instead. I'm not sure when both the input and output changed, but someone more knowledgeable should probably retroactively correct the documentation thereof.\r\n\r\nI stumbled across this issue because docker 1.7's remote API started **throwing errors** when passed string values for `VolumesFrom` - it used to silently accept the empty string as a valid input. I don't count this as a bug, but it was certainly surprising.\r\n\r\n*As an aside there has GOT to be a better way to arrange all of these docs besides a series of increasingly large and self-contradictory markdown files.*\r\n\r\n"}}
{"actor":{"display_login":"LK4D4"}}