docs.rs to Build Fewer Targets by Default Starting May 2026
The Rust programming language community announced a significant breaking change for docs.rs, the official documentation hosting service for Rust crates. Effective May 1, 2026, docs.rs will alter its default build behavior to generate documentation for only the primary target, specifically x86_64-unknown-linux-gnu, unless developers explicitly request additional targets. Previously, the service automatically built documentation for five default targets. This strategic shift aims to optimize resource utilization and reduce build times, acknowledging that most Rust crates do not require platform-specific code variations. The update impacts new crate releases and any rebuilds of older versions. Developers needing multi-platform documentation must now define their desired targets explicitly within their Cargo.toml metadata. While this modifies the default workflow, docs.rs continues to support all targets available in the Rust toolchain. This move represents the next phase of optimizations initially introduced in 2020, allowing users to opt into fewer build targets. The announcement serves as a critical advisory for Rust maintainers to update their configuration files to ensure comprehensive documentation coverage across different operating systems and architectures if required.
Wire timeline
docs.rs to Build Fewer Targets by Default Starting May 2026
The Rust programming language community announced a significant breaking change for docs.rs, the official documentation hosting service for Rust crates. Effective May 1, 2026, docs.rs will alter its default build behavior to generate documentation for only the primary target, specifically x86_64-unknown-linux-gnu, unless developers explicitly request additional targets. Previously, the service automatically built documentation for five default targets. This strategic shift aims to optimize resource utilization and reduce build times, acknowledging that most Rust crates do not require platform-specific code variations. The update impacts new crate releases and any rebuilds of older versions. Developers needing multi-platform documentation must now define their desired targets explicitly within their Cargo.toml metadata. While this modifies the default workflow, docs.rs continues to support all targets available in the Rust toolchain. This move represents the next phase of optimizations initially introduced in 2020, allowing users to opt into fewer build targets. The announcement serves as a critical advisory for Rust maintainers to update their configuration files to ensure comprehensive documentation coverage across different operating systems and architectures if required.
Rust Blog