A Philosophy of Software Design

by John Ousterhout

When documenting a variable, think nouns, not verbs. In other words, focus on what the variable represents, not how it is manipulated.

Code itself will document the manipulation.