Concrete examples in code comments are an antidote to information lost when abstracting

An important part of writing code is abstracting real values into variables. After abstraction, the real values are often forgotten, but the next coder needs to know what real values look like to use the code. Record real values in code comments to help the next coder.

For examples,

// E.g. "Jane Doe"
string name;

// E.g. "Jane" or "John"
string name;

// E.g. "+61412345678", not "0412345678"
string phone;

// E.g. "123 Smith Rd"
string address;

/* E.g.
123 Smith Rd
Mount Hill
6123
AUSTRALIA
*/
string address;

// E.g. "6123", "EH16 6UM"
string postCode;

// E.g. 60
int countdownMinutes;

// E.g. 1999, not 99
int year;