readme: add link to the cargo documentation on docs.rs

[matthiaskrgr]

Rendered

Background: I was searching for cargo source code doc a while back, found the cargo book and crates.io doc relatively quickly but not the actual source code doc which I only found (after way to much time had passed) when I looked up the cargo crate on crates.io and found the "Documentation" link :/

Hope this improves the situation a bit in the future.

[rust-highfive]

r? @matklad

(rust_highfive has picked a reviewer for you, use r? to override)

[matklad]

Hm, what about moving it to CONTRIBUTING.md or ARCHITECTURE.md? I think README.md, at least in theory, is more targeted on the users of Cargo, and they may be confused by this, especially if they are new to Rust

[matthiaskrgr]

Hmm, good point.
On the other hand, I assume that most people that view the readme do so on github or after having cloned the repo, and most people who clone the repo are probably somewhat interested in also modifying its code.

Also I have to admit that when searching for the code docs, I did not even consider looking into CONTRIBUTING.md or ARCHITECTURE.md so that would not have helped at least in my case :/

[matklad]

Hm, I have no particularly strong feeling either way here, so let's

r? @alexcrichton

:)

[alexcrichton]

Perhaps this could be placed under "Code status" and hopefully that'll scope it well enough?

[matthiaskrgr]

Sounds good, updated.

[alexcrichton]

@bors: r+

[bors]

📌 Commit ddffe60 has been approved by alexcrichton

[bors]

⌛ Testing commit ddffe60 with merge 40486ce...

[bors]

☀️ Test successful - status-appveyor, status-travis
Approved by: alexcrichton
Pushing 40486ce to master...