I'll Be Backend
Search lessons / @illbebackend
Principles

Rename for Intent: Meaningful Variable Names

Renaming for intent means giving every variable, field and number a name that says what it means, so the code explains itself. Short names and bare numbers force the next reader to guess, and a wrong guess turns a small change into a bug. These lessons rename a library's late-fine calculation step by step until adding a grace period is a one-line change.

Pick your language

Clean code: rename for intent in Java, step 2: A grace period that never appliesJava · ~4 minRename for Intent in JavaClean code: rename for intent in Kotlin, step 2: A grace period that never appliesKotlin · ~4 minRename for Intent in KotlinClean code: rename for intent in C#, step 2: A grace period that never appliesC# · ~4 minRename for Intent in C#Clean code: rename for intent in C++, step 2: A grace period that never appliesC++ · ~4 minRename for Intent in C++Clean code: rename for intent in Python, step 2: A grace period that never appliesPython · ~4 minRename for Intent in PythonClean code: rename for intent in Ruby, step 2: A grace period that never appliesRuby · ~4 minRename for Intent in RubyClean code: rename for intent in PHP, step 2: A grace period that never appliesPHP · ~4 minRename for Intent in PHPClean code: rename for intent in TypeScript, step 2: A grace period that never appliesTypeScript · ~4 minRename for Intent in TypeScriptClean code: rename for intent in Go, step 2: A grace period that never appliesGo · ~4 minRename for Intent in GoClean code: rename for intent in Swift, step 2: A grace period that never appliesSwift · ~4 minRename for Intent in Swift

When to use it

Use it when

You have to read a method's body to learn what one of its names means.

Skip it when

A short name lives in a tiny scope and is already clear, like i in a three-line loop.

Spot it by

Single letters, names like data, flag or calc, bare numbers, and comments that explain what a variable holds.