23
Literate Programming
(www.literateprogramming.com)
Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!
Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.
Hope you enjoy the instance!
Rules
Follow the wormhole through a path of communities !webdev@programming.dev
Code - not function. Files often have multiple functions in them. If you can't read and understand code - I don't want you on my team.
If it's something people will simply skip over then it's not useful. Don't pollute code with tons of unnecessary comments that you think will be useful for some "perceived future". They just add to your maintenance work.
Write your code to be understandable and document the architecture/design separately.
Agree - most code is pretty straight forward. Save the comments for where it's needed.