Closed
Description
#116016 made some changes to how the prelude items are structured which causes some problems with how the documentation is generated:
- While the 2024 edition is unstable, searching for stable attribute macros like
derive
leads you to a page that says the attribute is unstable. This is misleading, it is the re-export that is unstable. The search index only shows one entry, and the unstable page doesn't tell you why it is unstable.- Example: Go to https://doc.rust-lang.org/1.84.0/core/index.html and search for
derive
. It will lead you to https://doc.rust-lang.org/1.84.0/core/prelude/rust_2024/attr.derive.html which says it is unstable.
- Example: Go to https://doc.rust-lang.org/1.84.0/core/index.html and search for
- Some of the pages are now duplicated. Example:
- This is inconsistent with the other edition preludes, which use
doc(no_inline)
. - This may cause problems with future editions, which need to figure out how to structure this similar problem.
I would like to propose that after #134272 merges to undo the introduction of the common
module, and revert it back to the previous state where rust_2024
re-exports v1
with doc(no_inline)
. Unfortunately this will break/delete existing pages like https://doc.rust-lang.org/core/prelude/rust_2024/attr.derive.html. I'm personally fine with that.