Как писать код, который не пугает через неделю

Как писать код, который не пугает через неделю

1) Сначала дай функции одно маленькое дело. SRP = Single Responsibility Principle, то есть функция делает только одну понятную задачу. Если в ней и логика, и форматирование, и отправка — потом сложно искать баг.

2) Next: называй переменные так, чтобы их можно было читать без «расшифровки». Хорошее имя отвечает на вопрос «что это?», а не «как я это сокращал в спешке». userCount понятнее, чем uc.

3) Потом проверь, можно ли убрать повтор. DRY = Don't Repeat Yourself, смысл в том, чтобы не копировать один и тот же кусок в 3 местах. Копия почти всегда ломается первой.

4) И наконец, оставь коду подсказки: короткие комментарии только там, где намерение не видно из кода. Не объясняй очевидное — объясняй «почему так».

Попробуй сегодня взять один свой старый файл и найти в нём 1 дублирование и 1 плохое имя. Не worry if сначала заметишь только мелочь — это уже хороший старт.