Миф или правда
Правда ли, что комментарии нужны компьютеру, чтобы лучше понять программу?
Миф
Комментарии нужны компьютеру, чтобы лучше понять программу
На самом деле
Нет: исполнитель пропускает их целиком; комментарии пишут для людей — в том числе для себя через месяц.
Комментарий — что это на самом деле
Текст в коде, который исполнитель не читает: в скетчах Arduino — всё после // до конца строки. Пишут для людей, в том числе для себя через месяц: объясняют замысел («зачем»), а не пересказывают команду («что»). Комментарием также временно отключают строку кода — удобно при отладке.
Фрагменты исходника, отбрасываемые при трансляции: однострочные (// в C++, # в Python) и блочные (/* … */). Хороший комментарий фиксирует намерение и неочевидные решения; устаревший — вреднее отсутствующего, потому что врёт. Особый случай…
Аналогия: Пометки карандашом на полях книги: текст книги они не меняют, а понять его помогают.
Полное определение →Это понятие вводят примерно 13-14 лет (7-8 класс).