crates-io: Add doc comment for NewCrate struct

[Turbo87]

This PR adds a small doc comment to the NewCrate struct in the crates-io package, linking to https://doc.rust-lang.org/cargo/reference/registry-web-api.html#publish to give additional context.

I saw other links to https://doc.rust-lang.org in some of the doc comments, so I'm hoping this is correct vs. linking directly to the file with a relative path?

[rustbot]

r? @epage

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

[epage]

Just need to bump the version of the crate so it gets a release with this change.

[Turbo87]

probably no need to bump it just for this change. it was mostly helpful for me while browsing the cargo codebase :)

[Turbo87]

oh wait, now that I see the failing CI... did you mean to say that I should bump the version myself? how are changelogs etc. handled in that case?

[epage]

Yes, to fix CI the version needs to be bumped. Its a crude check, making us release more often than we would otherwise, but we've had too many times where we forgot to release.

So far we don't have per-crate changelogs. I'm researching options for that.

[epage]

@bors r+

[bors]

📌 Commit 9e5dac1 has been approved by epage

It is now in the queue for this repository.

[epage]

Thanks!

[bors]

⌛ Testing commit 9e5dac1 with merge 294fe8f...

[bors]

☀️ Test successful - checks-actions
Approved by: epage
Pushing 294fe8f to master...

[bors]

☀️ Test successful - checks-actions
Approved by: epage
Pushing 294fe8f to master...

[bors]

👀 Test was successful, but fast-forwarding failed: 422 Changes must be made through a pull request.