{"action":"created","comment":{"url":"https://api.github.com/repos/docker/docker/pulls/comments/55582699","id":55582699,"diff_hunk":"@@ -0,0 +1,62 @@\n+% DOCKER(1) Docker User Manuals","path":"man/docker-volume.1.md","position":1,"original_position":1,"commit_id":"dc8259f0ac094e28c8aae93435951fc336cd1d7b","original_commit_id":"dc8259f0ac094e28c8aae93435951fc336cd1d7b","user":{"login":"moxiegirl","id":1347209,"avatar_url":"https://avatars.githubusercontent.com/u/1347209?v=3","gravatar_id":"","url":"https://api.github.com/users/moxiegirl","html_url":"https://github.com/moxiegirl","followers_url":"https://api.github.com/users/moxiegirl/followers","following_url":"https://api.github.com/users/moxiegirl/following{/other_user}","gists_url":"https://api.github.com/users/moxiegirl/gists{/gist_id}","starred_url":"https://api.github.com/users/moxiegirl/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/moxiegirl/subscriptions","organizations_url":"https://api.github.com/users/moxiegirl/orgs","repos_url":"https://api.github.com/users/moxiegirl/repos","events_url":"https://api.github.com/users/moxiegirl/events{/privacy}","received_events_url":"https://api.github.com/users/moxiegirl/received_events","type":"User","site_admin":false},"body":"@rhatdan I think, at least since we need to come back and take another look, we should keep the info relatively light and refer them to the online docs. Hopefully, this can address @cpuguy83 's comment and unstick this pr.\r\n\r\n--> https://gist.github.com/moxiegirl/f2d374b4c2e57c976a1b\r\n\r\n% DOCKER(1) Docker User Manuals\r\n% Docker Community\r\n% Feb 2016\r\n# NAME\r\ndocker-volume - Create a new volume\r\n\r\n# SYNOPSIS\r\n**docker volume** [OPTIONS] COMMAND\r\n[**--help**]\r\n\r\n# DESCRIPTION\r\n\r\ndocker-volume has subcommands for managing data volumes.\r\n\r\n# SYNOPSIS\r\n**docker volume** \r\n[**--help**]\r\n[**create**|**inspect**|**ls**|**rm**]\r\n\r\n\r\n## Data volumes\r\n\r\nThe **docker volume** command has subcommands for managing data volumes. A *data\r\nvolume* is a specially-designated directory that by-passes storage driver\r\nmanagement. \r\n\r\nData volumes persist data independent of a container's life cycle. When you\r\ndelete a container, the Engine daemon does not delete any data volumes. You can\r\nshare volumes across multiple containers. Moreover, you can share data volumes\r\nwith other computing resources in your system.\r\n\r\nTo see help for a subcommand, use:\r\n\r\n    docker volume CMD help\r\n\r\nFor full details on using **docker volume** visit Docker's online documentation.\r\n\r\n# OPTIONS\r\n**--help**\r\n  Print usage statement\r\n\r\n# COMMANDS\r\n**create**\r\n  Create a volume\r\n  See **docker-volume-create(1)** for full documentation on the **create** command.\r\n\r\n**inspect**\r\n  Return low-level information on a volume\r\n  See **docker-volume-inspect(1)** for full documentation on the **inspect** command.\r\n\r\n**ls**\r\n  List volumes\r\n  See **docker-volume-ls(1)** for full documentation on the **ls** command.\r\n\r\n**rm**\r\n  Remove a volume\r\n  See **docker-volume-rm(1)** for full documentation on the **rm** command.\r\n\r\n# HISTORY\r\nFeb 2016, created by Dan Walsh <dwalsh@redhat.com>","created_at":"2016-03-09T20:22:39Z","updated_at":"2016-03-09T20:22:39Z","html_url":"https://github.com/docker/docker/pull/20190#discussion_r55582699","pull_request_url":"https://api.github.com/repos/docker/docker/pulls/20190","_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/comments/55582699"},"html":{"href":"https://github.com/docker/docker/pull/20190#discussion_r55582699"},"pull_request":{"href":"https://api.github.com/repos/docker/docker/pulls/20190"}}},"pull_request":{"url":"https://api.github.com/repos/docker/docker/pulls/20190","id":58894300,"html_url":"https://github.com/docker/docker/pull/20190","diff_url":"https://github.com/docker/docker/pull/20190.diff","patch_url":"https://github.com/docker/docker/pull/20190.patch","issue_url":"https://api.github.com/repos/docker/docker/issues/20190","number":20190,"state":"open","locked":false,"title":"Add a parent man page for docker volumes command","user":{"login":"rhatdan","id":2000835,"avatar_url":"https://avatars.githubusercontent.com/u/2000835?v=3","gravatar_id":"","url":"https://api.github.com/users/rhatdan","html_url":"https://github.com/rhatdan","followers_url":"https://api.github.com/users/rhatdan/followers","following_url":"https://api.github.com/users/rhatdan/following{/other_user}","gists_url":"https://api.github.com/users/rhatdan/gists{/gist_id}","starred_url":"https://api.github.com/users/rhatdan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rhatdan/subscriptions","organizations_url":"https://api.github.com/users/rhatdan/orgs","repos_url":"https://api.github.com/users/rhatdan/repos","events_url":"https://api.github.com/users/rhatdan/events{/privacy}","received_events_url":"https://api.github.com/users/rhatdan/received_events","type":"User","site_admin":false},"body":"It is difficult to gather information about docker volumes command\r\nwithout a parent man page.\r\n\r\nThis man page attempts to explain docker volumes and then references\r\nthe command man pages.\r\n\r\nSigned-off-by: Dan Walsh <dwalsh@redhat.com>","created_at":"2016-02-10T14:05:22Z","updated_at":"2016-03-09T20:22:39Z","closed_at":null,"merged_at":null,"merge_commit_sha":"0e84c93173bbf4da0e94eb9327a9d807ff5877a7","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/docker/docker/pulls/20190/commits","review_comments_url":"https://api.github.com/repos/docker/docker/pulls/20190/comments","review_comment_url":"https://api.github.com/repos/docker/docker/pulls/comments{/number}","comments_url":"https://api.github.com/repos/docker/docker/issues/20190/comments","statuses_url":"https://api.github.com/repos/docker/docker/statuses/dc8259f0ac094e28c8aae93435951fc336cd1d7b","head":{"label":"rhatdan:volumeMan","ref":"volumeMan","sha":"dc8259f0ac094e28c8aae93435951fc336cd1d7b","user":{"login":"rhatdan","id":2000835,"avatar_url":"https://avatars.githubusercontent.com/u/2000835?v=3","gravatar_id":"","url":"https://api.github.com/users/rhatdan","html_url":"https://github.com/rhatdan","followers_url":"https://api.github.com/users/rhatdan/followers","following_url":"https://api.github.com/users/rhatdan/following{/other_user}","gists_url":"https://api.github.com/users/rhatdan/gists{/gist_id}","starred_url":"https://api.github.com/users/rhatdan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rhatdan/subscriptions","organizations_url":"https://api.github.com/users/rhatdan/orgs","repos_url":"https://api.github.com/users/rhatdan/repos","events_url":"https://api.github.com/users/rhatdan/events{/privacy}","received_events_url":"https://api.github.com/users/rhatdan/received_events","type":"User","site_admin":false},"repo":{"id":16552047,"name":"docker","full_name":"rhatdan/docker","owner":{"login":"rhatdan","id":2000835,"avatar_url":"https://avatars.githubusercontent.com/u/2000835?v=3","gravatar_id":"","url":"https://api.github.com/users/rhatdan","html_url":"https://github.com/rhatdan","followers_url":"https://api.github.com/users/rhatdan/followers","following_url":"https://api.github.com/users/rhatdan/following{/other_user}","gists_url":"https://api.github.com/users/rhatdan/gists{/gist_id}","starred_url":"https://api.github.com/users/rhatdan/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rhatdan/subscriptions","organizations_url":"https://api.github.com/users/rhatdan/orgs","repos_url":"https://api.github.com/users/rhatdan/repos","events_url":"https://api.github.com/users/rhatdan/events{/privacy}","received_events_url":"https://api.github.com/users/rhatdan/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/rhatdan/docker","description":"Docker - the open-source application container engine","fork":true,"url":"https://api.github.com/repos/rhatdan/docker","forks_url":"https://api.github.com/repos/rhatdan/docker/forks","keys_url":"https://api.github.com/repos/rhatdan/docker/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rhatdan/docker/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rhatdan/docker/teams","hooks_url":"https://api.github.com/repos/rhatdan/docker/hooks","issue_events_url":"https://api.github.com/repos/rhatdan/docker/issues/events{/number}","events_url":"https://api.github.com/repos/rhatdan/docker/events","assignees_url":"https://api.github.com/repos/rhatdan/docker/assignees{/user}","branches_url":"https://api.github.com/repos/rhatdan/docker/branches{/branch}","tags_url":"https://api.github.com/repos/rhatdan/docker/tags","blobs_url":"https://api.github.com/repos/rhatdan/docker/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rhatdan/docker/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rhatdan/docker/git/refs{/sha}","trees_url":"https://api.github.com/repos/rhatdan/docker/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rhatdan/docker/statuses/{sha}","languages_url":"https://api.github.com/repos/rhatdan/docker/languages","stargazers_url":"https://api.github.com/repos/rhatdan/docker/stargazers","contributors_url":"https://api.github.com/repos/rhatdan/docker/contributors","subscribers_url":"https://api.github.com/repos/rhatdan/docker/subscribers","subscription_url":"https://api.github.com/repos/rhatdan/docker/subscription","commits_url":"https://api.github.com/repos/rhatdan/docker/commits{/sha}","git_commits_url":"https://api.github.com/repos/rhatdan/docker/git/commits{/sha}","comments_url":"https://api.github.com/repos/rhatdan/docker/comments{/number}","issue_comment_url":"https://api.github.com/repos/rhatdan/docker/issues/comments{/number}","contents_url":"https://api.github.com/repos/rhatdan/docker/contents/{+path}","compare_url":"https://api.github.com/repos/rhatdan/docker/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rhatdan/docker/merges","archive_url":"https://api.github.com/repos/rhatdan/docker/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rhatdan/docker/downloads","issues_url":"https://api.github.com/repos/rhatdan/docker/issues{/number}","pulls_url":"https://api.github.com/repos/rhatdan/docker/pulls{/number}","milestones_url":"https://api.github.com/repos/rhatdan/docker/milestones{/number}","notifications_url":"https://api.github.com/repos/rhatdan/docker/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rhatdan/docker/labels{/name}","releases_url":"https://api.github.com/repos/rhatdan/docker/releases{/id}","deployments_url":"https://api.github.com/repos/rhatdan/docker/deployments","created_at":"2014-02-05T17:24:31Z","updated_at":"2015-11-05T14:22:52Z","pushed_at":"2016-03-08T18:22:06Z","git_url":"git://github.com/rhatdan/docker.git","ssh_url":"git@github.com:rhatdan/docker.git","clone_url":"https://github.com/rhatdan/docker.git","svn_url":"https://github.com/rhatdan/docker","homepage":"http://www.docker.io","size":89209,"stargazers_count":9,"watchers_count":9,"language":"Go","has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":2,"forks":3,"open_issues":2,"watchers":9,"default_branch":"master"}},"base":{"label":"docker:master","ref":"master","sha":"e54ac9b3a1354daf7dd28f9bfd6fc411a25c4531","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}","deployments_url":"https://api.github.com/repos/docker/docker/deployments","created_at":"2013-01-18T18:10:57Z","updated_at":"2016-03-09T20:03:09Z","pushed_at":"2016-03-09T20:19:26Z","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":138563,"stargazers_count":29285,"watchers_count":29285,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":8215,"mirror_url":null,"open_issues_count":1388,"forks":8215,"open_issues":1388,"watchers":29285,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/docker/docker/pulls/20190"},"html":{"href":"https://github.com/docker/docker/pull/20190"},"issue":{"href":"https://api.github.com/repos/docker/docker/issues/20190"},"comments":{"href":"https://api.github.com/repos/docker/docker/issues/20190/comments"},"review_comments":{"href":"https://api.github.com/repos/docker/docker/pulls/20190/comments"},"review_comment":{"href":"https://api.github.com/repos/docker/docker/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/docker/docker/pulls/20190/commits"},"statuses":{"href":"https://api.github.com/repos/docker/docker/statuses/dc8259f0ac094e28c8aae93435951fc336cd1d7b"}}}}