Radar · Rust · Archive · Week 42 · Oct 13 – 19, 2025

docs.rs: changed default targets

Worth knowingtooling

What changed: docs.rs changed its default target platforms.
Production impact: The source does not say.
Try it: Build your crate with cargo doc and verify that the generated documentation is available for the new default targets.
Source: blog.rust-lang.org/2025/10/16/docsrs-changed-default-targets/

Understand it, then run it

Docs.rs is a service that builds and hosts Rust documentation. It automatically builds docs for a set of target platforms. The list of platforms it uses by default has changed. Apple’s new ARM64 chips (aarch64‑apple‑darwin) are now the default for macOS, replacing the older x86_64‑apple‑darwin. On Linux, the 64‑bit ARM target (aarch64‑unknown‑linux‑gnu) replaces the old 32‑bit i686 target. The full new default list is: - x86_64‑unknown‑linux‑gnu - aarch64‑apple‑darwin - x86_64‑pc‑windows‑msvc - aarch64‑unknown‑linux‑gnu - i686‑pc‑windows‑msvc

If you need the old list, you can specify it in your Cargo.toml under [package.metadata.docs.rs].

Run it now

Todayrust

// This program demonstrates the current default target list used by docs.rs.
// It prints the list of targets that docs.rs will build for by default.
// The list is hard‑coded here because the change is a configuration update
// on the docs.rs service, not a language feature.

fn main() {
    let default_targets = [
        "x86_64-unknown-linux-gnu",
        "aarch64-apple-darwin",
        "x86_64-pc-windows-msvc",
        "aarch64-unknown-linux-gnu",
        "i686-pc-windows-msvc",
    ];

    println!("Docs.rs default targets:");
    for target in &default_targets {
        println!(" - {}", target);
    }
}

What it printed when we ran it on Rust 1.98.1 (edition 2024)

Docs.rs default targets:
 - x86_64-unknown-linux-gnu
 - aarch64-apple-darwin
 - x86_64-pc-windows-msvc
 - aarch64-unknown-linux-gnu
 - i686-pc-windows-msvc

Run sends this program (for Solidity, the contract and its tests) to our own sandbox, where it is compiled and run once, with no network, and what it printed or the test report comes back here. Nothing is kept. Runs are counted per visitor for the day so everyone gets a turn; the details are on the legal page.

Written by gpt-oss-20b from the linked source · claims checked against the sources · archive, not individually reviewed