Man Rust is the shit! The compiler will build markdown documentation for you from comments in your code if you want it to! I have heard of stuff like this in other languages but never realized how powerful it is, a major problem in development is lack of documentation, and that is usually because the maintainers do not want to sit down and build documents. If you can do it while building though it makes everything so much easier.

@mister_monster nice dream.

Reality: code lacks of good comments too.
Follow

@loweel Lol true story but at least you can kill two birds with one stone. Documenting while coding means details are fresh and it isn't a separate time consuming process. I am already in the habit of commenting extensively, adding a litle markdown isn't much more.

@mister_monster

A single stone killed almost 98% of dinosaurs. So yes, you can kill more than two birds with a stone.

Maybe it could be easy to document functions and variables while coding. Unfortunately, apart of go (where the lint is forcing you to do ) , I don't see such a trend around....
Sign in to participate in the conversation
Mastodon 🔐 privacytools.io

Fast, secure and up-to-date instance. PrivacyTools provides knowledge and tools to protect your privacy against global mass surveillance.

Website: privacytools.io
Matrix Chat: chat.privacytools.io
Support us on OpenCollective, many contributions are tax deductible!