{"action":"created","issue":{"url":"https://api.github.com/repos/docker/docker/issues/10475","labels_url":"https://api.github.com/repos/docker/docker/issues/10475/labels{/name}","comments_url":"https://api.github.com/repos/docker/docker/issues/10475/comments","events_url":"https://api.github.com/repos/docker/docker/issues/10475/events","html_url":"https://github.com/docker/docker/pull/10475","id":56117683,"number":10475,"title":"refactoring: make a uniform description of docker commands","user":{"login":"HuKeping","id":9958621,"avatar_url":"https://avatars.githubusercontent.com/u/9958621?v=3","gravatar_id":"","url":"https://api.github.com/users/HuKeping","html_url":"https://github.com/HuKeping","followers_url":"https://api.github.com/users/HuKeping/followers","following_url":"https://api.github.com/users/HuKeping/following{/other_user}","gists_url":"https://api.github.com/users/HuKeping/gists{/gist_id}","starred_url":"https://api.github.com/users/HuKeping/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/HuKeping/subscriptions","organizations_url":"https://api.github.com/users/HuKeping/orgs","repos_url":"https://api.github.com/users/HuKeping/repos","events_url":"https://api.github.com/users/HuKeping/events{/privacy}","received_events_url":"https://api.github.com/users/HuKeping/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-01-31T08:19:27Z","updated_at":"2015-02-05T01:34:35Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/10475","html_url":"https://github.com/docker/docker/pull/10475","diff_url":"https://github.com/docker/docker/pull/10475.diff","patch_url":"https://github.com/docker/docker/pull/10475.patch"},"body":"We should guarantee the description of a docker command always be the same,\r\nin this case we would avoid many troubles. For example, typo caused by \"Modify\r\none place and Forget another\".\r\n\r\nIt is more simple and convenient to maintain.\r\n\r\nBy now, we put the description of docker-commands everywhere and sometimes not exact the same which I think may mislead the users.\r\n\r\nE.g.\r\nCmdStop\r\n- `docker help`: Stop a running container\r\n- `docker help stop`: Stop a running container by sending SIGTERM and then SIGKILL after a grace period\r\n- `docker stop --help`: see above\r\n\r\nCmdExport\r\n- `docker help`: Stream the contents of a container as a tar archive\r\n- `docker help export`: Export the contents of a filesystem as a tar archive to STDOUT\r\n- `docker export --help`: see above\r\n\r\nCmdSearch\r\n- `docker help`: Search for an image on the Docker Hub\r\n- `docker help search`: Search the Docker Hub for images\r\n- `docker search --help`: see above\r\n\r\nand many.\r\n\r\nI create a new file constant.go under utils/ for further work which I think there might be some other kinds of constant would like to join.\r\n\r\n\r\n  \r\n"},"comment":{"url":"https://api.github.com/repos/docker/docker/issues/comments/72978351","html_url":"https://github.com/docker/docker/pull/10475#issuecomment-72978351","issue_url":"https://api.github.com/repos/docker/docker/issues/10475","id":72978351,"user":{"login":"HuKeping","id":9958621,"avatar_url":"https://avatars.githubusercontent.com/u/9958621?v=3","gravatar_id":"","url":"https://api.github.com/users/HuKeping","html_url":"https://github.com/HuKeping","followers_url":"https://api.github.com/users/HuKeping/followers","following_url":"https://api.github.com/users/HuKeping/following{/other_user}","gists_url":"https://api.github.com/users/HuKeping/gists{/gist_id}","starred_url":"https://api.github.com/users/HuKeping/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/HuKeping/subscriptions","organizations_url":"https://api.github.com/users/HuKeping/orgs","repos_url":"https://api.github.com/users/HuKeping/repos","events_url":"https://api.github.com/users/HuKeping/events{/privacy}","received_events_url":"https://api.github.com/users/HuKeping/received_events","type":"User","site_admin":false},"created_at":"2015-02-05T01:34:35Z","updated_at":"2015-02-05T01:34:35Z","body":"hi @jfrazelle , is this not the right way to do things, I do think we can do something to improve the code tree about these \"Strings\" .\r\n\r\nI'm a little confused.  "}}