5 ms·
I wish there was something similar to the Haskell Haddock (https://www.haskell.org/haddock/ https://www.haskell.org/haddock/) for Rust. Something that would au
by HugoDaniel 7y ago
I wish there was something similar to the Haskell Haddock (https://www.haskell.org/haddock/ https://www.haskell.org/haddock/) for Rust.
Something that would automatically generate the signatures and modules entry points/data types. These seem to be very neglected and generally hard to keep up-to-date in the Rust ecosystem.
- codetrotter 7y agoI am not familiar with Haddock, as I've barely touched Haskell, but I do write a fair bit of Rust. Perhaps I am reading your comment wrong, but: - Generated Rust crate docs include signatures for all of their public functions, and - Generated Rust crate docs include public enums, public fields of public structs, etc
- OJFord 7y agoWhat does that do that Rust docs lack? e.g. here the signatures haven't been written manually... https://doc.rust-lang.org/std/string/struct.String.html https://doc.rust-lang.org/std/string/struct.String.html If you click 'src' at the top-right you'll see the full extent of the doc comments that generated it. (You get signatures without any comments.)