Вход
Наше всё
Теги
codebook
无线电组件
Поиск
Опросы
Закон
Вторник
23 июля
О смысле всего сущего
0xFF
Средства и методы разработки
Мобильная и беспроводная связь
Блошиный рынок
Объявления
Микроконтроллеры
PLD, FPGA, DSP
AVR
PIC
ARM, RISC-V
Технологии
Кибернетика, автоматика, протоколы
Схемы, платы, компоненты
Средства и методы разработки
1248764
Топик полностью
Bill
(11.10.2022 14:54, просмотров: 76)
ответил
Adept
на
я недавно открыл для себя (на самом деле читал это у кого-то, но потом успешно забыл), что даже подробнейший комментарий (которыми я снабжаю свои исходники) - абсолютно (ну почти) бесполезен, если просто повторяет и описывает конкретные действия операторов в строчке. Нужен именно функциональный комментарий,
"что это такое и зачем делается, и где используется, и где это важно"
Отчасти эту функцию несут блочные комментарии (в дополнение к строчным)
Всё уже написано до нас. Читайте Ван Тассела.
Ответить