Third-party cyber evaluations involving OpenAI models
openai.com·14h ago
Software Engineering
Rust Blog·5 min read
docs.rs: building fewer targets by default
TL;DR
docs.rs, a documentation hosting service for Rust packages, currently builds documentation for five default targets even when developers don't request them, consuming unnecessary resources. Starting May 1, 2026, docs.rs will build only the default target by default unless developers explicitly request additional targets.
✦ Why It Matters
Rust developers can reduce documentation build times by understanding docs.rs will now require explicit target configuration instead of building unnecessary platform variants.
Key Takeaways
- Change default behavior to build only the primary target.
- Specify additional targets in your Cargo.toml if needed.
- Optimize build times and resource usage for your crates.
- Customize the default target in your docs.rs metadata.
Full Summary
Currently, docs.rs builds documentation for five default targets unless specified otherwise in a crate's metadata. Beginning May 1, 2026, it will only build for the default target unless additional targets are explicitly requested.
This change follows a 2020 initiative allowing crates to opt for fewer build targets, recognizing that most crates do not require different code for various targets. By limiting builds to the default target, docs.rs aims to enhance efficiency, reduce build times, and conserve resources.
The default target is set to x86_64-unknown-linux-gnu, but can be customized in the crate's Cargo.toml file. Users can still specify multiple targets if needed, ensuring flexibility while streamlining the build process.