ВходНаше всё Теги codebook 无线电组件 Поиск Опросы Закон Воскресенье
21 июля
О смысле всего сущего0xFF Средства и методы разработки Мобильная и беспроводная связь Блошиный рынокОбъявления
МикроконтроллерыPLD, FPGA, DSP AVRPICARM, RISC-VТехнологии Кибернетика, автоматика, протоколы Схемы, платы, компоненты
1063585 Топик полностью
fk0, легенда (23.12.2020 00:25, просмотров: 370) ответил teap0t на Справедливости ради. Если человек, давно пишущий программы, не знает, что писать в комментах, то с ним что-то не так. Нет, именно русский активно отвлекал от сути. Как было сказано выше, "не заходит". fk0 послушал бы, конечно.
Я считаю, что нужно писать краткие комментарии о том, для чего нужны модуль, класс, функция, какие аргументы, какие возвращаемые значения, может быть назначение отдельных переменных, может комментировать отдельные абзацы кода. Причём писать не формальные комментарии (вида Callback(); // callback function), не doxygen из которого ничего не понятно, а своими словами, что подразумевалось, а не что в коде сделано. Потому, что бывает подразумевалось одно, а из-за ошибок и 

логических заблуждений сделано другое. И я считаю, что по-возможности, комментарии нужно писать на русском языке. Если организация не 100% российская, то приходится конечно на английском, но не считаю, что к этому нужно стремиться -- я в конце-концов на языке же и мыслю. И мыслить на чужом языке полноценно никогда не смогу. Смогу, но по-другому, примитивно.

[ZX]
Ответить