Omg yes! Rust just landed the `missing_doc_code_examples` lint on nightly! When enabled it ensures all documentation blocks will contain code examples! #![deny(missing_docs, missing_doc_code_examples)] Super excited about this!https://github.com/rust-lang/rust/issues/53805 …
-
-
I only remember seeing it in stdlib docs. I don't like it because it's mere noise, a case of consistency for its own sake. If there is more to say (context), sure, go for it, assuming it will be more than that one line of code.
-
assuming it will also not just be "this initialises SomeType, and here's how you use it"
End of conversation
New conversation -
Loading seems to be taking a while.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.