3 ms·
Nice obeservation, cargo doc is Rust's header files. When developing a library in Rust, I usually use cargo doc to "see the crate from the user's perspective".
by kzrdude 3y ago
Nice obeservation, cargo doc is Rust's header files. When developing a library in Rust, I usually use cargo doc to "see the crate from the user's perspective".
- elcritch 3y agoThat explains why so many docs for Rust packages are just a spew of types and traits. From the user perspective I really dislike just being thrown a bunch of types with minimal to no actual docs. It seems more common with Cstyle headers to add docs.
- kzrdude 3y agoIf it looks like that, then I think those developers did not take a look using the cargo doc perspective. I definitely do that to add docs in the right places. And warn(missing_docs) is good to use too (warn on any public item).