Источник: Nuances of Programming Курс SkillFactory Frontend-разработчик. Получите перспективную творческую профессию в IT. 1. Информативные и понятные имена В информатике есть лишь две сложные вещи: аннулирование кэша и присвоение имен (Филип Карлтон). Присвоение имен в любом языке программирования всегда сопряжено с определенными трудностями. Будь то функция, переменная или компонент, всегда нужно подобрать наиболее подходящее название. Удачное название должно быть кратким, точным и понятным. Например: Эти два понятия могут стать причиной некоторой двусмысленности: Todo и Item...

Со временем программы становятся всё сложнее и сложнее. Возникает необходимость добавлять комментарии, которые бы описывали, что делает код и почему. Комментарии могут находиться в любом месте скрипта. Они не влияют на его выполнение, поскольку движок просто игнорирует их. Однострочные комментарии начинаются с двойной косой черты //. Часть строки после // считается комментарием. Такой комментарий может как занимать строку целиком, так и находиться после инструкции. Как здесь: // Этот комментарий...