​​Точность именования

Любому программисту в процессе своей работы приходится постоянно давать имена различным переменным, классам, методам и функциям. От правильного наименования этих компонентов зависит, насколько долго придётся разбираться в коде поддерживающим данный код программистам.

Не до конца продуманная система именования существенно увеличивает время, затрачиваемое разработчиком на создание и поддержку кода. Так как несмотря даже на то, что он хорошо понимает свой собственный код, ему приходится каждый раз тратить много времени на вникание. Особенно сильно эта проблема усугубляется в коммерческих программах, содержащих сотни и тысячи данных компонентов.

Поэтому необходимо выбирать для своих элементов кода такие имена, которые позволяют любому читающему код быстро понять суть происходящего: что представляет собой та или иная переменная, для каких целей она была создана, как происходит её использование, в каких единицах происходит измерение её показателей.

Для примера посмотрим на следующие переменные:
int i;
int f;
double d;
String s;
Легко заметить, что эти переменные не говорят ни о чём. Единственный вариант знать об их
сущности — понимать контекст, в котором они применяются.

И сравним их с этими переменными:
int stagesInProcess;
int attemptsFromStart;
double temperatureGapInCelsius;
String employeeSurname;

Невооружённым глазом становится видна суть и назначение переменных.

Точность именования = скорость проектирования и поддержки.