Hasty Briefsbeta

双语

Building Docs.rs

a day ago
  • docs.rs 通过使用 cargo doc 和 rustdoc 从源代码构建 Rust 包的文档,这一过程资源消耗大且存在风险,因为 build.rs 可能执行任意代码。
  • 作者是一名从事 rcc C 编译器开发的 Rust 程序员,遇到了一个令人沮丧的问题:docs.rs 链接到特定版本,而重定向到最新版本时本应保持当前页面,却跳转到了首页。
  • 在问题持续存在约一年半之后,作者尝试贡献修复,但受限于基于 Vagrant 的过时本地开发环境而遇到困难。
  • 作者编写了一个用于本地开发的 Dockerfile,这给团队留下了深刻印象,随后被采用到生产环境中。
  • 经过约一个月的工作,最初的修改被合并,作者受邀加入 docs.rs 团队。
  • 作者持续贡献,并感谢社区的支持。