Concrete Naming

Every name and every comment should point at something real and current: a domain noun, a business rule, a fact that is true right now. Not at process (how the code got written), not at history (what it replaced), not at a vague abstraction that could mean anything.

That splits into three habits: order data names subject-first, order action names verb-first, and keep comments in the present tense.

1. Data: subject first, qualifier second

Types, classes, and variables name a thing. Lead with the concrete noun — the entity or subject — then attach the qualifier (state, role, relation) after it. Reading left to right should answer "what is this" before "what happened to it" or "what kind of role does it play."