{"action":"created","issue":{"url":"https://api.github.com/repos/docker/docker/issues/13367","labels_url":"https://api.github.com/repos/docker/docker/issues/13367/labels{/name}","comments_url":"https://api.github.com/repos/docker/docker/issues/13367/comments","events_url":"https://api.github.com/repos/docker/docker/issues/13367/events","html_url":"https://github.com/docker/docker/pull/13367","id":78712780,"number":13367,"title":"Add a \"Created\" state for new containers that haven't been run yet","user":{"login":"duglin","id":1944671,"avatar_url":"https://avatars.githubusercontent.com/u/1944671?v=3","gravatar_id":"","url":"https://api.github.com/users/duglin","html_url":"https://github.com/duglin","followers_url":"https://api.github.com/users/duglin/followers","following_url":"https://api.github.com/users/duglin/following{/other_user}","gists_url":"https://api.github.com/users/duglin/gists{/gist_id}","starred_url":"https://api.github.com/users/duglin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/duglin/subscriptions","organizations_url":"https://api.github.com/users/duglin/orgs","repos_url":"https://api.github.com/users/duglin/repos","events_url":"https://api.github.com/users/duglin/events{/privacy}","received_events_url":"https://api.github.com/users/duglin/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/docker/docker/labels/status/3-needs-docs-review","name":"status/3-needs-docs-review","color":"c7def8"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":37,"created_at":"2015-05-20T21:53:18Z","updated_at":"2015-05-30T13:18:28Z","closed_at":null,"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/13367","html_url":"https://github.com/docker/docker/pull/13367","diff_url":"https://github.com/docker/docker/pull/13367.diff","patch_url":"https://github.com/docker/docker/pull/13367.patch"},"body":"Closes #13353\r\n\r\nSigned-off-by: Doug Davis <dug@us.ibm.com>"},"comment":{"url":"https://api.github.com/repos/docker/docker/issues/comments/107040043","html_url":"https://github.com/docker/docker/pull/13367#issuecomment-107040043","issue_url":"https://api.github.com/repos/docker/docker/issues/13367","id":107040043,"user":{"login":"thaJeztah","id":1804568,"avatar_url":"https://avatars.githubusercontent.com/u/1804568?v=3","gravatar_id":"","url":"https://api.github.com/users/thaJeztah","html_url":"https://github.com/thaJeztah","followers_url":"https://api.github.com/users/thaJeztah/followers","following_url":"https://api.github.com/users/thaJeztah/following{/other_user}","gists_url":"https://api.github.com/users/thaJeztah/gists{/gist_id}","starred_url":"https://api.github.com/users/thaJeztah/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/thaJeztah/subscriptions","organizations_url":"https://api.github.com/users/thaJeztah/orgs","repos_url":"https://api.github.com/users/thaJeztah/repos","events_url":"https://api.github.com/users/thaJeztah/events{/privacy}","received_events_url":"https://api.github.com/users/thaJeztah/received_events","type":"User","site_admin":false},"created_at":"2015-05-30T13:18:28Z","updated_at":"2015-05-30T13:18:28Z","body":"@duglin I'm thinking something along the lines below. Assuming this will be in docker 1.8, feel free to adjust slightly if you have improvements.\r\n\r\nCan you add this juse above the https://github.com/docker/docker/blob/master/docs/sources/reference/commandline/cli.md#examples-2\r\n\r\n```Markdown\r\n> **Note:** the behavior of `docker create` changed in Docker 1.8.\r\n> Containers created with `docker create` now get an initial status\r\n> of `created` whereas previously the initial status was `exited`.\r\n```\r\n\r\n\r\n\r\nAnd add this above the https://github.com/docker/docker/blob/f1fed87fc01c31114b78a6ca9f7060fc93480957/docs/man/docker-create.1.md#options\r\nsection?\r\n\r\n```Markdown\r\n# DESCRIPTION\r\n\r\nCreates a writeable container layer over the specified image and prepares it for\r\nrunning the specified command. The container ID is then printed to STDOUT. This\r\nis similar to **docker run -d** except the container is never started. You can \r\nthen use the **docker start <container_id>** command to start the container at\r\nany point.\r\n\r\nNote: the behavior of **docker create** changed in Docker 1.8.\r\nContainers created with **docker create** now get an initial status\r\nof 'created' whereas previously the initial status was 'exited'.\r\n```\r\n"}}