Re:Ask HN: If you had the time, what software would you build?
by danieltillett on Monday August 31, 2015 @12:32AM
(#10145426)
Even better a system that would not let you check in code if the comments were not updated. Something simple like a section in the comment with a common tag, a checksum on the code, a check sum on the comment, and a human readable number that said how many lines the comment applied to. Something like:
This could be updated automatically and be backward compatible with current system. You would just need some sort of hook in git/etc to calculate and update the check sums and issue warning/errors if code checksum changed, but the comment checksum didn’t.
//[common tag]-[code checksum]-[comment checksum]-25
This could be updated automatically and be backward compatible with current system. You would just need some sort of hook in git/etc to calculate and update the check sums and issue warning/errors if code checksum changed, but the comment checksum didn’t.