# 文档注释常用章节
- `# Examples`
- Panics：函数可能发生panic的场景
- Errors：如果函数返回Result，描述可能的错误种类
- Safety：如果函数处于unsafe调用，就应该解释函数unsafe的原因以及调用者确保的使用前提
# 发布crate
为crate添加元数据，需要在`cargo.toml`的package区域添加信息
- crate唯一名称：name
- description：一两句话即可
- license：提供许可证标识值，可到http://spdx.org/licenses查找
> 可指定多个，用OR隔开
- version
- author
- 使用`cargo publish`命令