官方 Rust Book `main` 分支更新与 `doc.rust-lang.org/book/` 发布不同步导致的用户困惑

[zxzxovo]

问题描述

注意到 Rust 官方书籍的 rust-lang/book 会持续更新内容，但这些更新并不会立即同步到官方的在线版本 doc.rust-lang.org/book/ 中。

例如，最近的 commit e694be 更新了 19-01, 19-02, 19-03 章节的内容，但这些改动尚未反映在 doc.rust-lang.org/book/ 上。

本书的 README 中提到：

每章翻译开头都带有官方链接和 commit hash 的注释，若发现与官方不一致，欢迎 Issue 或 PR

若按照官方仓库的 commit hash 进行翻译更新，可能会造成官方在线文档与中文翻译的内容不一致，这种内容差异可能会让中英文对照阅读的读者感到困惑。

可能的解决方案

在 rust-lang/book 的 CONTRIBUTING 中提到：

Checking for Fixes
The book rides the Rust release trains. Therefore, if you see a problem on https://doc.rust-lang.org/stable/book, it may already be fixed on the main branch in this repo, but the fix hasn't gone through nightly -> beta -> stable yet. Please check the main branch in this repo before reporting an issue.

Expectations
Because the book is printed, and because we want to keep the online version of the book close to the print version when possible, it may take longer than you're used to for us to address your issue or pull request.

我感觉有比较充足的理由与官方在线版保持一致。因此应修改本仓库的 README ，或再编写一个 CONTRIBUTING.md 详细说明贡献本书的应知道具体细节，声明在比对 commit hash 时应与官方仓库最后一次部署之前的做对比。

• 可以在 Github Pages 看到上次部署是在 2024年10月25日 ，因此在比对 commit hash 时应忽略在此之后的提交。
• 如果出于其他原因本书有理由与最新提交而不是官方在线版内容保持一致，应在本书的开头做出对可能与官方在线版内容出现差异的说明。