rust-lang / rust-lang/rust

Cleanup bootstrap `rust-docs` dist component handling

Open
#151,292 0 comments 1 reaction 1 assignee View on GitHub

@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_steps which is way too implicit; instead, explicitly enumerate the "default steps" that should be included as part of the "preset" Doc step.

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::Linkcheck
  • test::HtmlCheck

(Needs further investigation, there are some convoluted recursive logic)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.