dont-look-back: never correct the past. A comment may not deny a state the codebase no longer has. A negation whose only referent is history ("not wire data", "no longer cached") is noise to a reader who never saw the old code; state the property positively instead. Negations that forestall a misreading of the current code ("not thread-safe", "not owned; caller frees") are still correct and still expected.
Comments
Sign in to join the discussion.
No comments yet. Be the first.