@
Akitora rust 目前很多时候需要你知道 how to do, 而不是 what I need.
新手和老手最大的问题在于: 新手完全不会看
docs.rs ,而老手认为
docs.rs 给出的信息已经足够丰富了,很多情况下不需要单独写 document 了,直接看 API 就可以了。
举个例子,我做了一个 DateTime 的扩展库,加了一个 to_timestamp 的方法。 那么在
docs.rs 里面,我都告诉你 impl MyTrait for DateTime { fn to_timestamp()} 了,这已经很明显很明显了。 应该一眼就能看出来。 但是新手往往会问你,这个库要怎么用。
一是,新手完全不会看
docs.rs二是,大部分新手还没搞懂 其他语言 class 和 interface 与 Rust 的 trait 的区别。没能扭过「 rust 可以直接在结构体上追加特性」的特性
怎么阅读 TRPL ,
docs.rs ,
crates.rs ,
libs.rs 可能俨然成为新时代下 Rust 新手的必备但是没人教的技能之一。