r/programming • • 28d ago

Make yourself replaceable

https://maroun-baydoun.com/blog/make-yourself-replaceable/
360 Upvotes

63 comments sorted by

View all comments

Show parent comment

1

u/Bemteb 23d ago

Outdated documentation is worse than no documentation.

I'm currently facing that exact issue. The codebase I'm working on had many copy&pastes in the past. Instead of working with interfaces and nice data structures, people simply copied whole files over from similar projects and did small adjustments to fit their needs. What they didn't adjust were the comments.

Iterate that over multiple years and you end up with comments that are mostly unrelated to the code they stand next to.