Cleanup bootstrap `rust-docs` dist component handling
Open
@Kobzol is already working on this.
Since Jan 29, 2026.
C-cleanup
E-medium
E-needs-investigation
T-bootstrap
- Dominant language
- Rust
- Stars
- 119k
- Forks
- 16.2k
- PR merge metrics
- PR metrics pending
Description
This is a long-standing cleanup that needs to be done eventually:
- Get rid of
doc_out-- using the same shared directory for multiple doc steps is wrong, there should be an explicit "build separately but eventually merge together" step to prevent any possibility of doc step artifacts stepping over each other. - Do not rely on
run_default_doc_stepswhich is way too implicit; instead, explicitly enumerate the "default steps" that should be included as part of the "preset"Docstep.
For the "implicit" part, note that we use this logic for both rust-docs dist component and rustc-docs dist component.
For the "explict" part, we also ensure them in:
test::Linkchecktest::HtmlCheck
(Needs further investigation, there are some convoluted recursive logic)
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.