{"action":"created","issue":{"url":"https://api.github.com/repos/docker/docker/issues/17085","labels_url":"https://api.github.com/repos/docker/docker/issues/17085/labels{/name}","comments_url":"https://api.github.com/repos/docker/docker/issues/17085/comments","events_url":"https://api.github.com/repos/docker/docker/issues/17085/events","html_url":"https://github.com/docker/docker/pull/17085","id":111695334,"number":17085,"title":"Correct API docs for /images/create","user":{"login":"dnephin","id":442180,"avatar_url":"https://avatars.githubusercontent.com/u/442180?v=3","gravatar_id":"","url":"https://api.github.com/users/dnephin","html_url":"https://github.com/dnephin","followers_url":"https://api.github.com/users/dnephin/followers","following_url":"https://api.github.com/users/dnephin/following{/other_user}","gists_url":"https://api.github.com/users/dnephin/gists{/gist_id}","starred_url":"https://api.github.com/users/dnephin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dnephin/subscriptions","organizations_url":"https://api.github.com/users/dnephin/orgs","repos_url":"https://api.github.com/users/dnephin/repos","events_url":"https://api.github.com/users/dnephin/events{/privacy}","received_events_url":"https://api.github.com/users/dnephin/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/docker/docker/labels/status/3-docs-review","name":"status/3-docs-review","color":"c7def8"}],"state":"closed","locked":false,"assignee":{"login":"tiborvass","id":827131,"avatar_url":"https://avatars.githubusercontent.com/u/827131?v=3","gravatar_id":"","url":"https://api.github.com/users/tiborvass","html_url":"https://github.com/tiborvass","followers_url":"https://api.github.com/users/tiborvass/followers","following_url":"https://api.github.com/users/tiborvass/following{/other_user}","gists_url":"https://api.github.com/users/tiborvass/gists{/gist_id}","starred_url":"https://api.github.com/users/tiborvass/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tiborvass/subscriptions","organizations_url":"https://api.github.com/users/tiborvass/orgs","repos_url":"https://api.github.com/users/tiborvass/repos","events_url":"https://api.github.com/users/tiborvass/events{/privacy}","received_events_url":"https://api.github.com/users/tiborvass/received_events","type":"User","site_admin":false},"milestone":{"url":"https://api.github.com/repos/docker/docker/milestones/41","html_url":"https://github.com/docker/docker/milestones/1.9.0","labels_url":"https://api.github.com/repos/docker/docker/milestones/41/labels","id":1211905,"number":41,"title":"1.9.0","description":"","creator":{"login":"dmp42","id":332946,"avatar_url":"https://avatars.githubusercontent.com/u/332946?v=3","gravatar_id":"","url":"https://api.github.com/users/dmp42","html_url":"https://github.com/dmp42","followers_url":"https://api.github.com/users/dmp42/followers","following_url":"https://api.github.com/users/dmp42/following{/other_user}","gists_url":"https://api.github.com/users/dmp42/gists{/gist_id}","starred_url":"https://api.github.com/users/dmp42/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dmp42/subscriptions","organizations_url":"https://api.github.com/users/dmp42/orgs","repos_url":"https://api.github.com/users/dmp42/repos","events_url":"https://api.github.com/users/dmp42/events{/privacy}","received_events_url":"https://api.github.com/users/dmp42/received_events","type":"User","site_admin":false},"open_issues":18,"closed_issues":91,"state":"open","created_at":"2015-07-16T20:50:09Z","updated_at":"2015-10-16T18:23:20Z","due_on":"2015-10-29T07:00:00Z","closed_at":null},"comments":5,"created_at":"2015-10-15T19:57:49Z","updated_at":"2015-10-16T18:24:05Z","closed_at":"2015-10-16T17:10:41Z","pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/17085","html_url":"https://github.com/docker/docker/pull/17085","diff_url":"https://github.com/docker/docker/pull/17085.diff","patch_url":"https://github.com/docker/docker/pull/17085.patch"},"body":"The API docs for this endpoint are incomplete and from what I can tell just wrong in one case.\r\n\r\n* I can't see any reference in the code to a `registry` param. Maybe it was removed at some point?\r\n* this endpoint supports two operations (it should probably be split into two endpoints eventually), but each operation supports different sets of args. I tried to clarify which operation uses which args.\r\n* tags and digest can be included either as part of `fromImage` or in `tag`\r\n\r\nI think these fixes could probably be backported to the 1.20 api docs as well, but I wanted to get a review of the wording first, then I can copy it.\r\n\r\n+kind/docs\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/docker/docker/issues/comments/148792730","html_url":"https://github.com/docker/docker/pull/17085#issuecomment-148792730","issue_url":"https://api.github.com/repos/docker/docker/issues/17085","id":148792730,"user":{"login":"dnephin","id":442180,"avatar_url":"https://avatars.githubusercontent.com/u/442180?v=3","gravatar_id":"","url":"https://api.github.com/users/dnephin","html_url":"https://github.com/dnephin","followers_url":"https://api.github.com/users/dnephin/followers","following_url":"https://api.github.com/users/dnephin/following{/other_user}","gists_url":"https://api.github.com/users/dnephin/gists{/gist_id}","starred_url":"https://api.github.com/users/dnephin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dnephin/subscriptions","organizations_url":"https://api.github.com/users/dnephin/orgs","repos_url":"https://api.github.com/users/dnephin/repos","events_url":"https://api.github.com/users/dnephin/events{/privacy}","received_events_url":"https://api.github.com/users/dnephin/received_events","type":"User","site_admin":false},"created_at":"2015-10-16T18:24:05Z","updated_at":"2015-10-16T18:24:05Z","body":"I'm not entirely sure how far back it needs to ported, it's probably not entirely necessary."}}