Rendered Rustc book out of sync: wasm32-wasip2 should be documented as Tier-2 target

[ifsheldon]

Location

Hi! Today I looked up rustc book for the support of wasm32-wasip2 target. I found the website is still documenting wasm32-wasip2 as a Tier-3 target.

And I looked up the source code.

rust/src/doc/rustc/src/platform-support.md

Line 196 in e6c1e14

[`wasm32-wasip2`](platform-support/wasm32-wasip2.md) | ✓ | WebAssembly with WASIp2

The table has been updated, but the document of wasm32-wasip2 is still out of date.

rust/src/doc/rustc/src/platform-support/wasm32-wasip2.md

Line 3 in e6c1e14

**Tier: 3**

These seems a bit weird to me:

• The table and the specific document for wasm32-wasip2 on the website are both out of date.
• The table in the source code is up to date, while the specific document is out of date.

This issue may also reflect some procedural issues when promoting a target? I saw #129997 and #129998, but they seem not to be enforcing syncs on the rustc book.

I don't know anything about the publication process of rustc book, but I think it should be at least updated when stable Rust 1.82 was announced.

Summary

The published website of rustc book is out of date, documenting wasm32-wasip2 as a Tier-3 target. The source code of rustc book is also partially out of data and out of sync.

[jieyouxu]

cc @alexcrichton

[alexcrichton]

My mistake, fixed in #133213

[ifsheldon]

@alexcrichton I think the content in the document should also be updated?

For example:

rust/src/doc/rustc/src/platform-support/wasm32-wasip2.md

Line 67 in e6c1e14

The default set of WebAssembly features enabled for compilation is currently the

I guess (very likely) this is no longer true. I didn't dig into the differences, though.

[ifsheldon]

Besides, when will the published Rustc book website get updated? I think it should be updated when a stable release of Rust is announced, so the fixes should be "backported" to 1.82 rustc book?

[alexcrichton]

I believe that documentation about enabled features is correct, are you seeing otherwise though?

I also believe the book is updated based on releases of Rust. For example there is:

• https://doc.rust-lang.org/stable/rustc/ - updated on stable releases
• https://doc.rust-lang.org/beta/rustc/ - updated on beta releases
• https://doc.rust-lang.org/nightly/rustc/ - updated on nightly releases

(I could have outdated knowledge though)