{"action":"created","issue":{"url":"https://api.github.com/repos/docker/distribution/issues/1831","repository_url":"https://api.github.com/repos/docker/distribution","labels_url":"https://api.github.com/repos/docker/distribution/issues/1831/labels{/name}","comments_url":"https://api.github.com/repos/docker/distribution/issues/1831/comments","events_url":"https://api.github.com/repos/docker/distribution/issues/1831/events","html_url":"https://github.com/docker/distribution/issues/1831","id":165058624,"number":1831,"title":"What is a digest or reference of manifest?","user":{"login":"least-olegs","id":16243408,"avatar_url":"https://avatars.githubusercontent.com/u/16243408?v=3","gravatar_id":"","url":"https://api.github.com/users/least-olegs","html_url":"https://github.com/least-olegs","followers_url":"https://api.github.com/users/least-olegs/followers","following_url":"https://api.github.com/users/least-olegs/following{/other_user}","gists_url":"https://api.github.com/users/least-olegs/gists{/gist_id}","starred_url":"https://api.github.com/users/least-olegs/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/least-olegs/subscriptions","organizations_url":"https://api.github.com/users/least-olegs/orgs","repos_url":"https://api.github.com/users/least-olegs/repos","events_url":"https://api.github.com/users/least-olegs/events{/privacy}","received_events_url":"https://api.github.com/users/least-olegs/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":6,"created_at":"2016-07-12T11:40:15Z","updated_at":"2016-07-21T17:55:58Z","closed_at":null,"body":"The documentation is completely opaque when it describes deleting images:\r\n\r\n> \r\nFor deletes, reference must be a digest or the delete will fail. If the image exists and has been successfully deleted, the following response will be issued:\r\n\r\nThis is extremely unhelpful given how many places in Docker look like digests of something (strings of random numbers).\r\n\r\nWhatever \"digest\" is, it is not included in response when retrieving a list of images. Also, it is possible to retrieve a manifest w/o specifying any \"digests\", so why is it needed here?\r\n\r\nOn top of all of this: why is the API user needs to know about how you manage the storage - manifests, blobs etc. - it's your internal business the user wants no part of. Users know images via names and tags - why suddenly do the user needs so much information when it comes to deleting?"},"comment":{"url":"https://api.github.com/repos/docker/distribution/issues/comments/234332406","html_url":"https://github.com/docker/distribution/issues/1831#issuecomment-234332406","issue_url":"https://api.github.com/repos/docker/distribution/issues/1831","id":234332406,"user":{"login":"RichardScothern","id":922018,"avatar_url":"https://avatars.githubusercontent.com/u/922018?v=3","gravatar_id":"","url":"https://api.github.com/users/RichardScothern","html_url":"https://github.com/RichardScothern","followers_url":"https://api.github.com/users/RichardScothern/followers","following_url":"https://api.github.com/users/RichardScothern/following{/other_user}","gists_url":"https://api.github.com/users/RichardScothern/gists{/gist_id}","starred_url":"https://api.github.com/users/RichardScothern/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/RichardScothern/subscriptions","organizations_url":"https://api.github.com/users/RichardScothern/orgs","repos_url":"https://api.github.com/users/RichardScothern/repos","events_url":"https://api.github.com/users/RichardScothern/events{/privacy}","received_events_url":"https://api.github.com/users/RichardScothern/received_events","type":"User","site_admin":false},"created_at":"2016-07-21T17:55:58Z","updated_at":"2016-07-21T17:55:58Z","body":"hello @BrendonW .  When you curl the manifest, the digest is included in the header.  This is documented in the API reference in the manifest section: https://docs.docker.com/registry/spec/api/#/pulling-an-image\r\n\r\nNow, obviously there is some deficiency in the documentation given that you and @least-olegs are having such problems finding information.  As a user you will be more aware of this than the maintainers who created it.   \r\n\r\nIn what way can this be improved?  Do we need a tutorial?  Are you willing to contribute back to the project to help improve matters?"}}
{"actor":{"display_login":"RichardScothern"}}