docs.rs с 1 мая собирает документацию только для одной платформы по умолчанию

С 1 мая 2026 года docs.rs по умолчанию строит документацию крейта только для одной платформы — той, на которой работают серверы сборки. Раньше крейт без явного списка целей собирался под пять платформ.

Что меняется

По умолчанию будет собираться только x86_64-unknown-linux-gnu. Если автор крейта задал список целей в метаданных docs.rs — он по-прежнему будет использоваться. Сам сервис поддерживает любую платформу, доступную в тулчейне; меняется только поведение по умолчанию.

Почему

Большинство крейтов не имеют платформенно-зависимого кода, а лишние сборки тратят время и ресурсы сервиса. Это очередной шаг в движении, начатом ещё в 2020 году, когда docs.rs научили собирать меньше целей по желанию.

Что это сломает

Документация, зависящая от платформы, исчезнет с части страниц. Например, методы, доступные только под Windows, или код под #[cfg(target_arch)] перестанут отображаться — хотя в коде они есть.

Изменение затрагивает и новые релизы, и пересборку старых. То есть крейт может годами показывать полную документацию, а после пересборки потерять часть страниц.

Как починить

Прописать список целей в Cargo.toml в секции метаданных docs.rs. Это одна строка и предсказуемое поведение: документация будет собираться ровно там, где указано.

Это стоит сделать и без непосредственной необходимости: полагаться на список по умолчанию значит зависеть от решения сервиса.

Оригинал

docs.rs: building fewer targets by default от 4 апреля 2026 года