Писать код легко, но писать хороший код — искусство. Роберт Мартин подробно описал в книге «Clean Code». Clean Code JavaScript — практическое руководство.
1. Понятные имена
Плохо: const d = new Date(). Хорошо: const currentDate = new Date(). Имена переменных и функций должны отражать смысл.
2. Небольшие функции
Каждая функция выполняет одну задачу. 100 строк — плохо. 10–20 строк — хорошо. Одна задача — одна функция.
3. Комментарии
Код должен быть понятен сам по себе. Комментарии только где нужно. Пишите «Почему», а не «Что».
4. DRY и KISS
DRY — Don't Repeat Yourself. Повторяющийся код — выносите в функцию. KISS — Keep It Simple. Простота лучше всего.
5. Форматирование
Последовательные отступы. Разделение пустыми строками. Prettier, ESLint — автоматически.
Заключение
Чистый код — экономит время ваше и команды.
Источник: Clean Code JavaScript
