{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker/pulls/comments/23881655","id":23881655,"diff_hunk":"@@ -291,28 +291,22 @@ auto-extraction capability, you should always use `COPY`.\n \n ### [`ENTRYPOINT`](https://docs.docker.com/reference/builder/#entrypoint)\n \n-The best use for `ENTRYPOINT` is as a helper script. Using `ENTRYPOINT` for\n-other tasks can make your code harder to understand. For example,\n+The best use for `ENTRYPOINT` is as the main command. \n \n-....docker run -it official-image bash\n+Let's start with an example, of an image for the cli tool `s3cmd`:\n \n-is much easier to understand than\n+    ENTRYPOINT [\"s3cmd\"]\n+    CMD [\"--help\"]\n \n-....docker run -it --entrypoint bash official-image -i\n+Now people who consume this image can easily run commands via syntax like the\n+following:\n \n-This is especially true for new Docker users, who might naturally assume the","path":"docs/sources/articles/dockerfile_best-practices.md","position":19,"original_position":19,"commit_id":"d2129195f39808c306e81aeccbc4d27cad261b02","original_commit_id":"d2129195f39808c306e81aeccbc4d27cad261b02","user":{"login":"jfrazelle","id":1445228,"avatar_url":"https://avatars.githubusercontent.com/u/1445228?v=3","gravatar_id":"","url":"https://api.github.com/users/jfrazelle","html_url":"https://github.com/jfrazelle","followers_url":"https://api.github.com/users/jfrazelle/followers","following_url":"https://api.github.com/users/jfrazelle/following{/other_user}","gists_url":"https://api.github.com/users/jfrazelle/gists{/gist_id}","starred_url":"https://api.github.com/users/jfrazelle/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jfrazelle/subscriptions","organizations_url":"https://api.github.com/users/jfrazelle/orgs","repos_url":"https://api.github.com/users/jfrazelle/repos","events_url":"https://api.github.com/users/jfrazelle/events{/privacy}","received_events_url":"https://api.github.com/users/jfrazelle/received_events","type":"User","site_admin":false},"body":"Also \"best practices\" are not for new users but advanced ones.","created_at":"2015-01-30T23:56:09Z","updated_at":"2015-01-30T23:56:09Z","html_url":"https://github.com/docker/docker/pull/10470#discussion_r23881655","pull_request_url":"https://api.github.com/repos/docker/docker/pulls/10470","_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/23881655"},"html":{"href":"https://github.com/docker/docker/pull/10470#discussion_r23881655"},"pull_request":{"href":"https://api.github.com/repos/docker/docker/pulls/10470"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/10470","id":28403135,"html_url":"https://github.com/docker/docker/pull/10470","diff_url":"https://github.com/docker/docker/pull/10470.diff","patch_url":"https://github.com/docker/docker/pull/10470.patch","issue_url":"https://api.github.com/repos/docker/docker/issues/10470","number":10470,"state":"open","locked":false,"title":"Update best practices for entrypoint.","user":{"login":"jfrazelle","id":1445228,"avatar_url":"https://avatars.githubusercontent.com/u/1445228?v=3","gravatar_id":"","url":"https://api.github.com/users/jfrazelle","html_url":"https://github.com/jfrazelle","followers_url":"https://api.github.com/users/jfrazelle/followers","following_url":"https://api.github.com/users/jfrazelle/following{/other_user}","gists_url":"https://api.github.com/users/jfrazelle/gists{/gist_id}","starred_url":"https://api.github.com/users/jfrazelle/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jfrazelle/subscriptions","organizations_url":"https://api.github.com/users/jfrazelle/orgs","repos_url":"https://api.github.com/users/jfrazelle/repos","events_url":"https://api.github.com/users/jfrazelle/events{/privacy}","received_events_url":"https://api.github.com/users/jfrazelle/received_events","type":"User","site_admin":false},"body":"Despite being wrong we are kinda calling our users dumb, I feel it is a bit\r\ndemeaning. As well as just wrong.\r\n\r\nping @crosbymichael @aluzzardi @vieux \r\n","created_at":"2015-01-30T23:49:58Z","updated_at":"2015-01-30T23:56:09Z","closed_at":null,"merged_at":null,"merge_commit_sha":"9ca7abffcb981ebc3b98103337cb2514282d9e30","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/docker/docker/pulls/10470/commits","review_comments_url":"https://api.github.com/repos/docker/docker/pulls/10470/comments","review_comment_url":"https://api.github.com/repos/docker/docker/pulls/comments/{number}","comments_url":"https://api.github.com/repos/docker/docker/issues/10470/comments","statuses_url":"https://api.github.com/repos/docker/docker/statuses/d2129195f39808c306e81aeccbc4d27cad261b02","head":{"label":"jfrazelle:real-dockerfile-best-practices","ref":"real-dockerfile-best-practices","sha":"d2129195f39808c306e81aeccbc4d27cad261b02","user":{"login":"jfrazelle","id":1445228,"avatar_url":"https://avatars.githubusercontent.com/u/1445228?v=3","gravatar_id":"","url":"https://api.github.com/users/jfrazelle","html_url":"https://github.com/jfrazelle","followers_url":"https://api.github.com/users/jfrazelle/followers","following_url":"https://api.github.com/users/jfrazelle/following{/other_user}","gists_url":"https://api.github.com/users/jfrazelle/gists{/gist_id}","starred_url":"https://api.github.com/users/jfrazelle/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jfrazelle/subscriptions","organizations_url":"https://api.github.com/users/jfrazelle/orgs","repos_url":"https://api.github.com/users/jfrazelle/repos","events_url":"https://api.github.com/users/jfrazelle/events{/privacy}","received_events_url":"https://api.github.com/users/jfrazelle/received_events","type":"User","site_admin":false},"repo":{"id":21672903,"name":"docker","full_name":"jfrazelle/docker","owner":{"login":"jfrazelle","id":1445228,"avatar_url":"https://avatars.githubusercontent.com/u/1445228?v=3","gravatar_id":"","url":"https://api.github.com/users/jfrazelle","html_url":"https://github.com/jfrazelle","followers_url":"https://api.github.com/users/jfrazelle/followers","following_url":"https://api.github.com/users/jfrazelle/following{/other_user}","gists_url":"https://api.github.com/users/jfrazelle/gists{/gist_id}","starred_url":"https://api.github.com/users/jfrazelle/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jfrazelle/subscriptions","organizations_url":"https://api.github.com/users/jfrazelle/orgs","repos_url":"https://api.github.com/users/jfrazelle/repos","events_url":"https://api.github.com/users/jfrazelle/events{/privacy}","received_events_url":"https://api.github.com/users/jfrazelle/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/jfrazelle/docker","description":"Docker - the open-source application container engine","fork":true,"url":"https://api.github.com/repos/jfrazelle/docker","forks_url":"https://api.github.com/repos/jfrazelle/docker/forks","keys_url":"https://api.github.com/repos/jfrazelle/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/jfrazelle/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/jfrazelle/docker/teams","hooks_url":"https://api.github.com/repos/jfrazelle/docker/hooks","issue_events_url":"https://api.github.com/repos/jfrazelle/docker/issues/events{/number}","events_url":"https://api.github.com/repos/jfrazelle/docker/events","assignees_url":"https://api.github.com/repos/jfrazelle/docker/assignees{/user}","branches_url":"https://api.github.com/repos/jfrazelle/docker/branches{/branch}","tags_url":"https://api.github.com/repos/jfrazelle/docker/tags","blobs_url":"https://api.github.com/repos/jfrazelle/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/jfrazelle/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/jfrazelle/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/jfrazelle/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/jfrazelle/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/jfrazelle/docker/languages","stargazers_url":"https://api.github.com/repos/jfrazelle/docker/stargazers","contributors_url":"https://api.github.com/repos/jfrazelle/docker/contributors","subscribers_url":"https://api.github.com/repos/jfrazelle/docker/subscribers","subscription_url":"https://api.github.com/repos/jfrazelle/docker/subscription","commits_url":"https://api.github.com/repos/jfrazelle/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/jfrazelle/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/jfrazelle/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/jfrazelle/docker/issues/comments/{number}","contents_url":"https://api.github.com/repos/jfrazelle/docker/contents/{+path}","compare_url":"https://api.github.com/repos/jfrazelle/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/jfrazelle/docker/merges","archive_url":"https://api.github.com/repos/jfrazelle/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/jfrazelle/docker/downloads","issues_url":"https://api.github.com/repos/jfrazelle/docker/issues{/number}","pulls_url":"https://api.github.com/repos/jfrazelle/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/jfrazelle/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/jfrazelle/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/jfrazelle/docker/labels{/name}","releases_url":"https://api.github.com/repos/jfrazelle/docker/releases{/id}","created_at":"2014-07-10T00:00:33Z","updated_at":"2015-01-28T18:35:51Z","pushed_at":"2015-01-30T23:49:33Z","git_url":"git://github.com/jfrazelle/docker.git","ssh_url":"git@github.com:jfrazelle/docker.git","clone_url":"https://github.com/jfrazelle/docker.git","svn_url":"https://github.com/jfrazelle/docker","homepage":"http://www.docker.com","size":41695,"stargazers_count":0,"watchers_count":0,"language":"Go","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"docker:master","ref":"master","sha":"ee0b0464c692172c43735becbb00aae96f4f4c5e","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":7691631,"name":"docker","full_name":"docker/docker","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","description":"Docker - the open-source application container engine","fork":false,"url":"https://api.github.com/repos/docker/docker","forks_url":"https://api.github.com/repos/docker/docker/forks","keys_url":"https://api.github.com/repos/docker/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/docker/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/docker/docker/teams","hooks_url":"https://api.github.com/repos/docker/docker/hooks","issue_events_url":"https://api.github.com/repos/docker/docker/issues/events{/number}","events_url":"https://api.github.com/repos/docker/docker/events","assignees_url":"https://api.github.com/repos/docker/docker/assignees{/user}","branches_url":"https://api.github.com/repos/docker/docker/branches{/branch}","tags_url":"https://api.github.com/repos/docker/docker/tags","blobs_url":"https://api.github.com/repos/docker/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/docker/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/docker/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/docker/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/docker/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/docker/docker/languages","stargazers_url":"https://api.github.com/repos/docker/docker/stargazers","contributors_url":"https://api.github.com/repos/docker/docker/contributors","subscribers_url":"https://api.github.com/repos/docker/docker/subscribers","subscription_url":"https://api.github.com/repos/docker/docker/subscription","commits_url":"https://api.github.com/repos/docker/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/docker/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/docker/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/docker/docker/issues/comments/{number}","contents_url":"https://api.github.com/repos/docker/docker/contents/{+path}","compare_url":"https://api.github.com/repos/docker/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/docker/docker/merges","archive_url":"https://api.github.com/repos/docker/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/docker/docker/downloads","issues_url":"https://api.github.com/repos/docker/docker/issues{/number}","pulls_url":"https://api.github.com/repos/docker/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/docker/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/docker/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/docker/docker/labels{/name}","releases_url":"https://api.github.com/repos/docker/docker/releases{/id}","created_at":"2013-01-18T18:10:57Z","updated_at":"2015-01-30T23:33:09Z","pushed_at":"2015-01-30T23:22:50Z","git_url":"git://github.com/docker/docker.git","ssh_url":"git@github.com:docker/docker.git","clone_url":"https://github.com/docker/docker.git","svn_url":"https://github.com/docker/docker","homepage":"http://www.docker.com","size":130444,"stargazers_count":18821,"watchers_count":18821,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":3882,"mirror_url":null,"open_issues_count":996,"forks":3882,"open_issues":996,"watchers":18821,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/10470"},"html":{"href":"https://github.com/docker/docker/pull/10470"},"issue":{"href":"https://api.github.com/repos/docker/docker/issues/10470"},"comments":{"href":"https://api.github.com/repos/docker/docker/issues/10470/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker/pulls/10470/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/docker/docker/pulls/10470/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker/statuses/d2129195f39808c306e81aeccbc4d27cad261b02"}}}}