4 ms·
> as much as header files suck, they let you skim an API much more easily than Rust or Swift Just to reply to this individual point, rustdoc is fantastic. Pers
by dikaiosune 11y ago
> as much as header files suck, they let you skim an API much more easily than Rust or Swift
Just to reply to this individual point, rustdoc is fantastic. Personally I much prefer having an HTML-rendered "header file" for a crate's API. Even if they aren't hosted, it's trivial to generate one yourself using `cargo doc`. To be maximally useful, the author needs to have made doc comments, but at least there's a standard format for that, and you might not have anything like that in a header file anyways.
- autoreleasepool 11y agoSuper cool. I like everything they have going on with the triple slash comments too. Now all we need is an IDE that can get those docs up in a key stroke!
- heinrich5991 11y agoYou can try crates.fyi for hosted docs, e.g. https://crates.fyi/crates/itertools/0.4.7/ https://crates.fyi/crates/itertools/0.4.7/