I think you're throwing the baby out with the bath water, and I think module level comments are a perfectly reasonable place to address most of your concerns. (

I think you're throwing the baby out with the bath water, and I think module level comments are a perfectly reasonable place to address most of your concerns. (I don't know why they're "hacky.") Look for example at these docs, which are completely auto-generated from comments in the source: https://docs.rs/regex https://docs.rs/regex ... Here's another example: https://docs.rs/fst https://docs.rs/fst Note that I do think there's a limit to what auto-documentation can provide, but I think you're selling it pretty short.