3 ms·
If you have to write who wrote a piece of code in a comment, you must not be using a decent version control system with a blame command. Which is a problem you
by spellboots 13y ago
If you have to write who wrote a piece of code in a comment, you must not be using a decent version control system with a blame command. Which is a problem you should probably fix way before talking about comment styles.
- ErrantX 13y agoUh, that takes much longer. Blame is useful in more elaborate context but... comments are instant :) And that is important.
- jack9 13y ago> Blame is useful in more elaborate context but... comments are instant Blame is instant too, if you have a good and modern IDE. Can't always be relied upon, but once such a beast exists, just assume it's being used. Writing erlang? Sorry, inline comments. Writing JS/PHP? Leave it in git.
- vonmoltke 13y agoFair point, but I have two counterpoints: 1) Changing version control systems may be an unwinnable corporate political battle, while changing comment style may just be a team decision. 2) Not everyone who may need to understand or modify your code may have access to your repositories. I worked on a program where partner companies were provided source snapshots for developing their own algorithms but were not allowed access to our repositories.