Самый простой способ писать на 30% больше осмысленных комментариев
Если вам повезло и у вас есть согласованное с заказчиком тех. задание - КОПИПАСТ готовых фраз, это на самом деле - способ программировать быстрее.
Главное вовремя ловить себя на повторных Alt-Tab'aх и заменять их на Ctrl-C, Ctrl-Y :)
Документация открытая в браузере, тоже хороший поставшик, фраз для комментариев. Раз мне пришлось лазить за ней в интернет, значит эту информацию априори можно считать полезной. На крайний случай даже просто url - это хороший комментарий.
Еще одно простое правило, которое мне очень нравиться - писать комментарии на том языке на котором думаешь в этот момент. Я не русофоб, если англоязычная фраза в голове в данный момент не вертится, я предпочту, написать по-русски, а не торопять успеть до дедлайна, оставить сложное место непрокомментированным. Аналогично, как правило, после глубокого погружения в доки, бывают ситуации когда по русски выразить мысль сложнее чем на английском.
Проще потом, если необходимо пробежатся и привести все к одному виду, нежли постфактум мучительно придумывать глупые фразы.
Главное вовремя ловить себя на повторных Alt-Tab'aх и заменять их на Ctrl-C, Ctrl-Y :)
Документация открытая в браузере, тоже хороший поставшик, фраз для комментариев. Раз мне пришлось лазить за ней в интернет, значит эту информацию априори можно считать полезной. На крайний случай даже просто url - это хороший комментарий.
Еще одно простое правило, которое мне очень нравиться - писать комментарии на том языке на котором думаешь в этот момент. Я не русофоб, если англоязычная фраза в голове в данный момент не вертится, я предпочту, написать по-русски, а не торопять успеть до дедлайна, оставить сложное место непрокомментированным. Аналогично, как правило, после глубокого погружения в доки, бывают ситуации когда по русски выразить мысль сложнее чем на английском.
Проще потом, если необходимо пробежатся и привести все к одному виду, нежли постфактум мучительно придумывать глупые фразы.