{"action":"created","comment":{"url":"https://api.github.com/repos/rust-lang/cargo/pulls/comments/63251159","id":63251159,"diff_hunk":"@@ -104,41 +103,61 @@ Once you’re ready for release, you can use `cargo build --release` to compile\n <span style=\"font-weight: bold\"\n class=\"s1\">   Compiling</span> hello_world v0.1.0 (file:///path/to/project/hello_world)</code></pre>\n \n+`cargo build --release` puts the resulting binary in\n+`target/release/hello_world` instead of `target/debug`.","path":"src/doc/guide.md","position":46,"original_position":46,"commit_id":"9e0da6fb206a17b3c1d3b5251ebdc0249b2085bb","original_commit_id":"9e0da6fb206a17b3c1d3b5251ebdc0249b2085bb","user":{"login":"steveklabnik","id":27786,"avatar_url":"https://avatars.githubusercontent.com/u/27786?v=3","gravatar_id":"","url":"https://api.github.com/users/steveklabnik","html_url":"https://github.com/steveklabnik","followers_url":"https://api.github.com/users/steveklabnik/followers","following_url":"https://api.github.com/users/steveklabnik/following{/other_user}","gists_url":"https://api.github.com/users/steveklabnik/gists{/gist_id}","starred_url":"https://api.github.com/users/steveklabnik/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/steveklabnik/subscriptions","organizations_url":"https://api.github.com/users/steveklabnik/orgs","repos_url":"https://api.github.com/users/steveklabnik/repos","events_url":"https://api.github.com/users/steveklabnik/events{/privacy}","received_events_url":"https://api.github.com/users/steveklabnik/received_events","type":"User","site_admin":false},"body":"I would say \"puts it in `target/release` instead of\", it doesn't go in another folder named hello_world","created_at":"2016-05-13T21:06:41Z","updated_at":"2016-05-13T21:06:41Z","html_url":"https://github.com/rust-lang/cargo/pull/2688#discussion_r63251159","pull_request_url":"https://api.github.com/repos/rust-lang/cargo/pulls/2688","_links":{"self":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/comments/63251159"},"html":{"href":"https://github.com/rust-lang/cargo/pull/2688#discussion_r63251159"},"pull_request":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/2688"}}},"pull_request":{"url":"https://api.github.com/repos/rust-lang/cargo/pulls/2688","id":70057196,"html_url":"https://github.com/rust-lang/cargo/pull/2688","diff_url":"https://github.com/rust-lang/cargo/pull/2688.diff","patch_url":"https://github.com/rust-lang/cargo/pull/2688.patch","issue_url":"https://api.github.com/repos/rust-lang/cargo/issues/2688","number":2688,"state":"open","locked":false,"title":"Docs refresh","user":{"login":"carols10cents","id":193874,"avatar_url":"https://avatars.githubusercontent.com/u/193874?v=3","gravatar_id":"","url":"https://api.github.com/users/carols10cents","html_url":"https://github.com/carols10cents","followers_url":"https://api.github.com/users/carols10cents/followers","following_url":"https://api.github.com/users/carols10cents/following{/other_user}","gists_url":"https://api.github.com/users/carols10cents/gists{/gist_id}","starred_url":"https://api.github.com/users/carols10cents/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carols10cents/subscriptions","organizations_url":"https://api.github.com/users/carols10cents/orgs","repos_url":"https://api.github.com/users/carols10cents/repos","events_url":"https://api.github.com/users/carols10cents/events{/privacy}","received_events_url":"https://api.github.com/users/carols10cents/received_events","type":"User","site_admin":false},"body":"Hi! Sooooo I've been thinking about the cargo docs lately and today I decided to try some of the things I've been thinking about.\r\n\r\nThere are some smaller changes in here, typos and clarifications and stuff, that I'm totally willing to break out into a separate PR(s) if yinz want.\r\n\r\nMy goals for the larger changes were:\r\n\r\n- **Make one obvious place to go for info on every which way to specify a dependency.** I've found myself clicking around the different doc pages a lot to find the semver syntax, the different keys that can go with a git location, the `path` override syntax, etc. So I made one top-level \"Specifying Dependencies\" page and moved relevant info from the guide, the manifest page, and the crates.io page.\r\n- **Make The Guide a bit more focused.** There were a few topics in there that didn't really fit in the story arc of trying to get someone up and running with cargo-- it veered off into some more advanced topics that I've moved to places I think they fit better.\r\n- **Make the crates.io page only about publishing, not using and publishing.** The info about adding dependencies got folded into either the guide or the new specifying dependencies page, so this should close https://github.com/rust-lang/cargo/issues/1035. \r\n\r\nI'm also thinking about having someone new to rust/cargo try following the guide, but wanted to get a first pass from experienced people :)","created_at":"2016-05-13T20:57:29Z","updated_at":"2016-05-13T21:06:41Z","closed_at":null,"merged_at":null,"merge_commit_sha":"bf0089ab88902922581a3d03b5165c8b3aaeeac0","assignee":{"login":"alexcrichton","id":64996,"avatar_url":"https://avatars.githubusercontent.com/u/64996?v=3","gravatar_id":"","url":"https://api.github.com/users/alexcrichton","html_url":"https://github.com/alexcrichton","followers_url":"https://api.github.com/users/alexcrichton/followers","following_url":"https://api.github.com/users/alexcrichton/following{/other_user}","gists_url":"https://api.github.com/users/alexcrichton/gists{/gist_id}","starred_url":"https://api.github.com/users/alexcrichton/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alexcrichton/subscriptions","organizations_url":"https://api.github.com/users/alexcrichton/orgs","repos_url":"https://api.github.com/users/alexcrichton/repos","events_url":"https://api.github.com/users/alexcrichton/events{/privacy}","received_events_url":"https://api.github.com/users/alexcrichton/received_events","type":"User","site_admin":false},"milestone":null,"commits_url":"https://api.github.com/repos/rust-lang/cargo/pulls/2688/commits","review_comments_url":"https://api.github.com/repos/rust-lang/cargo/pulls/2688/comments","review_comment_url":"https://api.github.com/repos/rust-lang/cargo/pulls/comments{/number}","comments_url":"https://api.github.com/repos/rust-lang/cargo/issues/2688/comments","statuses_url":"https://api.github.com/repos/rust-lang/cargo/statuses/9e0da6fb206a17b3c1d3b5251ebdc0249b2085bb","head":{"label":"carols10cents:docs-refresh","ref":"docs-refresh","sha":"9e0da6fb206a17b3c1d3b5251ebdc0249b2085bb","user":{"login":"carols10cents","id":193874,"avatar_url":"https://avatars.githubusercontent.com/u/193874?v=3","gravatar_id":"","url":"https://api.github.com/users/carols10cents","html_url":"https://github.com/carols10cents","followers_url":"https://api.github.com/users/carols10cents/followers","following_url":"https://api.github.com/users/carols10cents/following{/other_user}","gists_url":"https://api.github.com/users/carols10cents/gists{/gist_id}","starred_url":"https://api.github.com/users/carols10cents/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carols10cents/subscriptions","organizations_url":"https://api.github.com/users/carols10cents/orgs","repos_url":"https://api.github.com/users/carols10cents/repos","events_url":"https://api.github.com/users/carols10cents/events{/privacy}","received_events_url":"https://api.github.com/users/carols10cents/received_events","type":"User","site_admin":false},"repo":{"id":24034128,"name":"cargo","full_name":"carols10cents/cargo","owner":{"login":"carols10cents","id":193874,"avatar_url":"https://avatars.githubusercontent.com/u/193874?v=3","gravatar_id":"","url":"https://api.github.com/users/carols10cents","html_url":"https://github.com/carols10cents","followers_url":"https://api.github.com/users/carols10cents/followers","following_url":"https://api.github.com/users/carols10cents/following{/other_user}","gists_url":"https://api.github.com/users/carols10cents/gists{/gist_id}","starred_url":"https://api.github.com/users/carols10cents/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carols10cents/subscriptions","organizations_url":"https://api.github.com/users/carols10cents/orgs","repos_url":"https://api.github.com/users/carols10cents/repos","events_url":"https://api.github.com/users/carols10cents/events{/privacy}","received_events_url":"https://api.github.com/users/carols10cents/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/carols10cents/cargo","description":"The Rust package manager","fork":true,"url":"https://api.github.com/repos/carols10cents/cargo","forks_url":"https://api.github.com/repos/carols10cents/cargo/forks","keys_url":"https://api.github.com/repos/carols10cents/cargo/keys{/key_id}","collaborators_url":"https://api.github.com/repos/carols10cents/cargo/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/carols10cents/cargo/teams","hooks_url":"https://api.github.com/repos/carols10cents/cargo/hooks","issue_events_url":"https://api.github.com/repos/carols10cents/cargo/issues/events{/number}","events_url":"https://api.github.com/repos/carols10cents/cargo/events","assignees_url":"https://api.github.com/repos/carols10cents/cargo/assignees{/user}","branches_url":"https://api.github.com/repos/carols10cents/cargo/branches{/branch}","tags_url":"https://api.github.com/repos/carols10cents/cargo/tags","blobs_url":"https://api.github.com/repos/carols10cents/cargo/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/carols10cents/cargo/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/carols10cents/cargo/git/refs{/sha}","trees_url":"https://api.github.com/repos/carols10cents/cargo/git/trees{/sha}","statuses_url":"https://api.github.com/repos/carols10cents/cargo/statuses/{sha}","languages_url":"https://api.github.com/repos/carols10cents/cargo/languages","stargazers_url":"https://api.github.com/repos/carols10cents/cargo/stargazers","contributors_url":"https://api.github.com/repos/carols10cents/cargo/contributors","subscribers_url":"https://api.github.com/repos/carols10cents/cargo/subscribers","subscription_url":"https://api.github.com/repos/carols10cents/cargo/subscription","commits_url":"https://api.github.com/repos/carols10cents/cargo/commits{/sha}","git_commits_url":"https://api.github.com/repos/carols10cents/cargo/git/commits{/sha}","comments_url":"https://api.github.com/repos/carols10cents/cargo/comments{/number}","issue_comment_url":"https://api.github.com/repos/carols10cents/cargo/issues/comments{/number}","contents_url":"https://api.github.com/repos/carols10cents/cargo/contents/{+path}","compare_url":"https://api.github.com/repos/carols10cents/cargo/compare/{base}...{head}","merges_url":"https://api.github.com/repos/carols10cents/cargo/merges","archive_url":"https://api.github.com/repos/carols10cents/cargo/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/carols10cents/cargo/downloads","issues_url":"https://api.github.com/repos/carols10cents/cargo/issues{/number}","pulls_url":"https://api.github.com/repos/carols10cents/cargo/pulls{/number}","milestones_url":"https://api.github.com/repos/carols10cents/cargo/milestones{/number}","notifications_url":"https://api.github.com/repos/carols10cents/cargo/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/carols10cents/cargo/labels{/name}","releases_url":"https://api.github.com/repos/carols10cents/cargo/releases{/id}","deployments_url":"https://api.github.com/repos/carols10cents/cargo/deployments","created_at":"2014-09-14T21:40:44Z","updated_at":"2014-09-14T10:29:32Z","pushed_at":"2016-05-13T20:47:27Z","git_url":"git://github.com/carols10cents/cargo.git","ssh_url":"git@github.com:carols10cents/cargo.git","clone_url":"https://github.com/carols10cents/cargo.git","svn_url":"https://github.com/carols10cents/cargo","homepage":"http://crates.io/","size":9260,"stargazers_count":0,"watchers_count":0,"language":null,"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":"rust-lang:master","ref":"master","sha":"7199e24439f7c1cd9c8fea14dbf4115a92823de9","user":{"login":"rust-lang","id":5430905,"avatar_url":"https://avatars.githubusercontent.com/u/5430905?v=3","gravatar_id":"","url":"https://api.github.com/users/rust-lang","html_url":"https://github.com/rust-lang","followers_url":"https://api.github.com/users/rust-lang/followers","following_url":"https://api.github.com/users/rust-lang/following{/other_user}","gists_url":"https://api.github.com/users/rust-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/rust-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rust-lang/subscriptions","organizations_url":"https://api.github.com/users/rust-lang/orgs","repos_url":"https://api.github.com/users/rust-lang/repos","events_url":"https://api.github.com/users/rust-lang/events{/privacy}","received_events_url":"https://api.github.com/users/rust-lang/received_events","type":"Organization","site_admin":false},"repo":{"id":17420913,"name":"cargo","full_name":"rust-lang/cargo","owner":{"login":"rust-lang","id":5430905,"avatar_url":"https://avatars.githubusercontent.com/u/5430905?v=3","gravatar_id":"","url":"https://api.github.com/users/rust-lang","html_url":"https://github.com/rust-lang","followers_url":"https://api.github.com/users/rust-lang/followers","following_url":"https://api.github.com/users/rust-lang/following{/other_user}","gists_url":"https://api.github.com/users/rust-lang/gists{/gist_id}","starred_url":"https://api.github.com/users/rust-lang/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rust-lang/subscriptions","organizations_url":"https://api.github.com/users/rust-lang/orgs","repos_url":"https://api.github.com/users/rust-lang/repos","events_url":"https://api.github.com/users/rust-lang/events{/privacy}","received_events_url":"https://api.github.com/users/rust-lang/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/rust-lang/cargo","description":"The Rust package manager","fork":false,"url":"https://api.github.com/repos/rust-lang/cargo","forks_url":"https://api.github.com/repos/rust-lang/cargo/forks","keys_url":"https://api.github.com/repos/rust-lang/cargo/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rust-lang/cargo/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rust-lang/cargo/teams","hooks_url":"https://api.github.com/repos/rust-lang/cargo/hooks","issue_events_url":"https://api.github.com/repos/rust-lang/cargo/issues/events{/number}","events_url":"https://api.github.com/repos/rust-lang/cargo/events","assignees_url":"https://api.github.com/repos/rust-lang/cargo/assignees{/user}","branches_url":"https://api.github.com/repos/rust-lang/cargo/branches{/branch}","tags_url":"https://api.github.com/repos/rust-lang/cargo/tags","blobs_url":"https://api.github.com/repos/rust-lang/cargo/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rust-lang/cargo/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rust-lang/cargo/git/refs{/sha}","trees_url":"https://api.github.com/repos/rust-lang/cargo/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rust-lang/cargo/statuses/{sha}","languages_url":"https://api.github.com/repos/rust-lang/cargo/languages","stargazers_url":"https://api.github.com/repos/rust-lang/cargo/stargazers","contributors_url":"https://api.github.com/repos/rust-lang/cargo/contributors","subscribers_url":"https://api.github.com/repos/rust-lang/cargo/subscribers","subscription_url":"https://api.github.com/repos/rust-lang/cargo/subscription","commits_url":"https://api.github.com/repos/rust-lang/cargo/commits{/sha}","git_commits_url":"https://api.github.com/repos/rust-lang/cargo/git/commits{/sha}","comments_url":"https://api.github.com/repos/rust-lang/cargo/comments{/number}","issue_comment_url":"https://api.github.com/repos/rust-lang/cargo/issues/comments{/number}","contents_url":"https://api.github.com/repos/rust-lang/cargo/contents/{+path}","compare_url":"https://api.github.com/repos/rust-lang/cargo/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rust-lang/cargo/merges","archive_url":"https://api.github.com/repos/rust-lang/cargo/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rust-lang/cargo/downloads","issues_url":"https://api.github.com/repos/rust-lang/cargo/issues{/number}","pulls_url":"https://api.github.com/repos/rust-lang/cargo/pulls{/number}","milestones_url":"https://api.github.com/repos/rust-lang/cargo/milestones{/number}","notifications_url":"https://api.github.com/repos/rust-lang/cargo/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rust-lang/cargo/labels{/name}","releases_url":"https://api.github.com/repos/rust-lang/cargo/releases{/id}","deployments_url":"https://api.github.com/repos/rust-lang/cargo/deployments","created_at":"2014-03-04T23:20:42Z","updated_at":"2016-05-13T12:53:20Z","pushed_at":"2016-05-13T20:57:29Z","git_url":"git://github.com/rust-lang/cargo.git","ssh_url":"git@github.com:rust-lang/cargo.git","clone_url":"https://github.com/rust-lang/cargo.git","svn_url":"https://github.com/rust-lang/cargo","homepage":"http://crates.io/","size":58905,"stargazers_count":1628,"watchers_count":1628,"language":"Rust","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":376,"mirror_url":null,"open_issues_count":298,"forks":376,"open_issues":298,"watchers":1628,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/2688"},"html":{"href":"https://github.com/rust-lang/cargo/pull/2688"},"issue":{"href":"https://api.github.com/repos/rust-lang/cargo/issues/2688"},"comments":{"href":"https://api.github.com/repos/rust-lang/cargo/issues/2688/comments"},"review_comments":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/2688/comments"},"review_comment":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/rust-lang/cargo/pulls/2688/commits"},"statuses":{"href":"https://api.github.com/repos/rust-lang/cargo/statuses/9e0da6fb206a17b3c1d3b5251ebdc0249b2085bb"}}}}