准确的包文档有助于其他用户理解如何以及何时使用它们，所以花一些时间编写文档是值得 的。第三章中我们讨论了如何使用双斜杠 // 注释 Rust 代码。Rust 也有特定的用于文档的注 释类型，通常被称为文档注释（documentation comments），它们会生成 HTML 文档。这些 HTML 展示公有 API 文档注释的内容，它们意在让对库感兴趣的程序员理解如何使用这个 crate，而不是它是如何被实现的。 文档注释使用三斜杠 publish Updating crates.io index warning: manifest has no description, license, license-file, documentation, 308/562Rust 程序设计语言 简体中文版 homepage or repository. See https://doc.rust-lang.org/cargo/reference/manifest 来指定文件名而不是使用 license 字段。 关于项目所适用的 license 指导超出了本书的范畴。很多 Rust 社区成员选择与 Rust 自身相同 的 license，这是一个双许可的 MIT OR Apache-2.0。这个实践展示了也可以通过 OR 分隔为项 目指定多个 license 标识符。 那么，有了唯一的名称、版本号、由 cargo new 新建项目时增加的作者信息、描述和所选择的 license，已经准备好发布的项目的