The Case Against Documenting Code

1 pointsposted 2 years ago
by thunderbong

4 Comments

kstenerud

2 years ago

Unfortunately, he neglected to mention exactly what he meant by "documentation", so his hand-wavey arguments can basically mean whatever you want them to mean, and any dissenting argument can easily be dismissed and diffused like the mountain of sand we're standing on.

lawls

2 years ago

Always document your code in a way that you feel the person replacing you some day can come back to and quickly get up to speed on why and how things work. Reclaim your future time by putting a little more effort into the present.

eschneider

2 years ago

That poor bastard who has to pick up your old code is likely to be you, so do a solid for future you. Document.

user

2 years ago

[deleted]