Document registries. #6594
Closed
Document registries. #6594
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Closed
7 tasks
carols10cents
suggested changes
Jan 26, 2019
src/doc/src/reference/registries.md
Outdated
| registry is [crates.io]. A registry contains an "index" which contains a | ||
| searchable list of available crates. A registry may also provide a web API to | ||
| support publishing new crates directly from Cargo. The registry provides | ||
| permanent access to all versions of a package that have been published to it. |
There was a problem hiding this comment.
The registry provides permanent access to all versions of a package that have been published to it.
This is a guarantee crates.io has chosen to make; other registries might choose not to make this guarantee. If "The registry" was changed to "crates.io", I think this'd be fine :)
There was a problem hiding this comment.
I just removed it, I feel like it wasn't saying anything useful or correct.
|
Thank you very much for the detailed review! It's frustrating when I read something many times and still miss the obvious mistakes. |
|
Moved to #6654. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
(Do not merge.)
Rendered
This is a preview of the documentation for registries, posted for early review. I intend to include it when actually stabilizing alternative registries. There are many minor places in the documentation that will get updated at that time, but that mostly involves removing unstable notices or adding small notes that are included here.
I would appreciate if someone on @rust-lang/crates-io would take a look over this at some point. This intentionally only documents a minimum of the web API that Cargo uses. The format is a bit ad-hoc, but I think it is clear enough to get the points across.