Комментировать нужно основные элементы кода, неочевидные решения, сложные бизнес-процессы, тонкости решений и тому подобное. Не пишите комментарии, объясняющие, что и как делает процедура или функция, — это бессмысленно. И помните, что комментарий — не панацея, он не спасёт плохой код, даже если сделает его понятнее.Aug 19, 2020
Комментарии нужны, но они должны описывать намерения кода или предупреждать о неявных подводных камнях. Если можно переписать код чтобы было ...
В последнее время меня стали очень утомлять оживлённые дебаты о том, нужно ли комментировать код. Как правило, по одну сторону баррикад ...
В ней автор описал множество способов по оптимизации кода, ... Когда у вас нет возможности комментировать всё, что находится слева, ...
Если вы создаёте библиотеку или фреймворк, которые будут использоваться другими разработчиками, то вам нужно будет разработать документацию для ...
Как мы знаем из главы Структура кода, комментарии могут быть ... какие-то тонкости и неочевидные вещи, его определённо нужно комментировать.
«Все знают», что исходный код надо комментировать. ... А менеджеру, в свою очередь, нужно внимательно следить за работой тим лида, ...
Это необходимо для вашего собственного удобства и удобства того, кто читает этот код. Следует отличать детали реализации (как процедура ...
В этой статье мы рассмотрим, как комментировать код JavaScript, какие типы комментариев существуют, а также некоторые передовые практики.
... закомментировать или раскомментировать введенные вручную строки кода или комментария. ... перетащите указатель мыши по строкам, которые нужно выбрать, ...