{"action":"opened","issue":{"url":"https://api.github.com/repos/docker/swarm/issues/2336","repository_url":"https://api.github.com/repos/docker/swarm","labels_url":"https://api.github.com/repos/docker/swarm/issues/2336/labels{/name}","comments_url":"https://api.github.com/repos/docker/swarm/issues/2336/comments","events_url":"https://api.github.com/repos/docker/swarm/issues/2336/events","html_url":"https://github.com/docker/swarm/issues/2336","id":158894681,"number":2336,"title":"[Documentation] Install for production is confusing","user":{"login":"dangoncalves","id":2377456,"avatar_url":"https://avatars.githubusercontent.com/u/2377456?v=3","gravatar_id":"","url":"https://api.github.com/users/dangoncalves","html_url":"https://github.com/dangoncalves","followers_url":"https://api.github.com/users/dangoncalves/followers","following_url":"https://api.github.com/users/dangoncalves/following{/other_user}","gists_url":"https://api.github.com/users/dangoncalves/gists{/gist_id}","starred_url":"https://api.github.com/users/dangoncalves/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dangoncalves/subscriptions","organizations_url":"https://api.github.com/users/dangoncalves/orgs","repos_url":"https://api.github.com/users/dangoncalves/repos","events_url":"https://api.github.com/users/dangoncalves/events{/privacy}","received_events_url":"https://api.github.com/users/dangoncalves/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2016-06-07T10:56:51Z","updated_at":"2016-06-07T10:56:51Z","closed_at":null,"body":"In install-manual.md, \"set up for a discovery backend\" step (step 4) tells to connect to manager0 and consul0 but connection to manager0 is not needed at this step. This is confusing because it can be interpreted as running the same command on consul0 and manager0.\r\n\r\n\"Create swarm cluster\" step (step 5) mentions that manager0 and consul0 is on the same host and the examples given use the same IP address for consul0 and manager0 but the \"create your instances\" step tells to create five different instances. This is really confusing and there is no other mention about using the consul0 and the manager0 on the same host.\r\n\r\nUsing different instances for consul0 and manager0 is simpler and works well. Documentation should not mention that consul0 and manager0 are on the same host, or it should at least explain, as an introduction, what you get by putting them on the same host."}}
{"actor":{"display_login":"dangoncalves"}}