-
Notifications
You must be signed in to change notification settings - Fork 12.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Re-write the documentation index #49628
Conversation
Your PR failed on Travis. Through arcane magic we have determined that the following fragments from the build log may contain information about the problem. Click to expand the log.
I'm a bot! I can only do what humans tell me to, so if this was not helpful or you have suggestions for improvements, please ping or otherwise contact |
src/doc/index.md
Outdated
[rustdoc-book]: rustdoc/index.html | ||
[cargo-book]: cargo/index.html | ||
diagnostics from the compiler on those errors. You can also [read them | ||
here](err-index.html), if you prefer to read them that way. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Link should point to error-index.html
Overall, this gets a 👍 from me, though it's kind of an overhaul and likely to generate lots of Opinions. I'd like to see what the rest of @rust-lang/docs thinks. |
The docs team has decided that we're framing resources in three ways: "learning Rust," "using Rust," "mastering Rust." This is a more useful split than "beginner/intermediate/advanced." As we add more resources in the future, we expect "using Rust" to grow. "the bookshelf" as a concept is great, but isn't really organized along these lines. As such, this reorganizes the docs along these lines.
6e3a003
to
77b570f
Compare
Let's do it this way: @rfcbot fcp merge |
Team member @steveklabnik has proposed to merge this. The next step is review by the rest of the tagged teams: No concerns currently listed. Once a majority of reviewers approve (and none object), this will enter its final comment period. If you spot a major issue that hasn't been raised at any point in this process, please speak up! See this document for info about what commands tagged team members can give me. |
Checked of @QuietMisdreavus as per 👍 above |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
looks great, love these new categories ✨
🔔 This is now entering its final comment period, as per the review above. 🔔 |
👍 |
@bors: r=QuietMisdreavus thanks everyone! |
📌 Commit 77b570f has been approved by |
…ietMisdreavus Re-write the documentation index The docs team has decided that we're framing resources in three ways: "learning Rust," "using Rust," "mastering Rust." This is a more useful split than "beginner/intermediate/advanced." As we add more resources in the future, we expect "using Rust" to grow. "the bookshelf" as a concept is great, but isn't really organized along these lines. As such, this reorganizes the docs along these lines.
Rollup of 25 pull requests Successful merges: - #49179 (Handle future deprecation annotations ) - #49512 (Add support for variant and types fields for intra links) - #49515 (fix targetted value background) - #49516 (Add missing anchor for union type fields) - #49532 (Add test for rustdoc ignore test) - #49533 (Add #[must_use] to a few standard library methods) - #49540 (Fix miri Discriminant() for non-ADT) - #49559 (Introduce Vec::resize_with method (see #41758)) - #49570 (avoid IdxSets containing garbage above the universe length) - #49577 (Stabilize String::replace_range) - #49599 (Fix typo) - #49603 (Fix url for intra link provided method) - #49607 (Stabilize iterator methods in 1.27) - #49609 (run-pass/attr-stmt-expr: expand test cases) - #49612 (Fix "since" version for getpid feature.) - #49618 (Fix build error when compiling libcore for 16bit targets) - #49619 (tweak core::fmt docs) - #49637 (Stabilize parent_id()) - #49639 (Update Cargo) - #49628 (Re-write the documentation index) - #49594 (Add some performance guidance to std::fs and std::io docs) - #49625 (miri: add public alloc_kind accessor) - #49634 (Add a test for the fix to issue #43058) - #49641 (Regression test for #46314) - #49547 (Unignore borrowck test) Failed merges:
The docs team has decided that we're framing resources in three ways:
"learning Rust," "using Rust," "mastering Rust." This is a more useful
split than "beginner/intermediate/advanced." As we add more resources
in the future, we expect "using Rust" to grow. "the bookshelf" as a
concept is great, but isn't really organized along these lines. As such,
this reorganizes the docs along these lines.
r? @rust-lang/docs