Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.
Sign upInternal crates are documented for stable but not nightly #27149
Comments
This comment has been minimized.
This comment has been minimized.
|
@SimonSapin from reading the dialogue on #23848, it seems like the purpose of that PR shifted over time: at first it was turning off doc-generation for a broad class of crates, both the compiler-internal ones and the ones hidden behind the But it was determined that turning off doc-generation for the crates behind the So, the end net result of #23848 (if you count the backout commit that landed later) seems to be just to turn off doc generation for the compiler crates alone, I think? |
This comment has been minimized.
This comment has been minimized.
That sounds fine, but doing it on nigthly but not on stable? |
steveklabnik
added
the
T-rustdoc
label
Jul 20, 2015
This comment has been minimized.
This comment has been minimized.
|
https://doc.rust-lang.org/stable/std/ does not include compiler-internal crates anymore which is at least consistent, but I still think that their documentation is useful when e.g. developing compiler plugins or working on the compiler itself. I’m not the only one: https://internals.rust-lang.org/t/documentation-for-libsyntax-friends/2498 |
This comment has been minimized.
This comment has been minimized.
|
Closing in favor of #29893. |
SimonSapin commentedJul 20, 2015
https://doc.rust-lang.org/stable/std/ documents many crates including rustc and syntax, whereas https://doc.rust-lang.org/nightly/std/ only has std and its dependencies. This seems backwards, and opposite of what the commit message for e64b677 / #23848 says.
CC @cmr