Reply to post: Chaff

Microsoft liberates ancient MS-DOS source from the museum and sticks it in GitHub

Spamfast Bronze badge
Stop

Chaff

It's good to see that even if the development language has changed over the last 35 years, some engineers have always hated writing history and comments.

If you don't have a revision control system then history is all well and good. But people who insist on putting revsion history in source files these days are time-wasters. We have commit messages for that.

Similarly for the filename and for function names and signatures in function block comments. All chaff and it all gets out of sync when someone changes the function without updating the comment.

And good source code needs very few comments if it's clearly structured using sensible symbol names. Lots of comments just to satisfy some metric or because your code is impenetrable is a sign of poor design & implementation.

POST COMMENT House rules

Not a member of The Register? Create a new account here.

  • Enter your comment

  • Add an icon

Anonymous cowards cannot choose their icon

Biting the hand that feeds IT © 1998–2019