this post was submitted on 28 Jul 2023
785 points (99.0% liked)

Programmer Humor

32560 readers
376 users here now

Post funny things about programming here! (Or just rant about your favourite programming language.)

Rules:

founded 5 years ago
MODERATORS
 
you are viewing a single comment's thread
view the rest of the comments
[โ€“] Dirk@lemmy.ml 2 points 1 year ago (1 children)

I produce text or HTML files anyway

I do extensive in-code documentation. The compiler discards all comments so I don't worry about commenting my code. Source code is for humans to understand and write anyways.

[โ€“] CallumWells@lemmy.ml 1 points 1 year ago

Also writing documentation in-code like JavaDoc or equivalents has always seemed great for me. Then you can have your toolchain generate the written documentation directly from that, and it can be updated easily based on what's actually documented in the code (but that does require that people keep that updated)