23 подписчика
Да, всё же подход к оформлению кода за тридцать лет изменился почти в полный наоборот.
Во времена, когда листинги кода не были очевидным образом структурированы, а названия переменных состояли из пары символов в лучшем случае (про подпрограммы вообще молчу, не везде они вообще названия имели), считалось необходимым писать подробные простыни комментариев.
А вот из гайда для джунов от сего года, 2022 по стандартному летосчислению:
===
Код должен быть понятен без комментариев и содержать их минимальное количество. Тогда при работе разработчику не придется погружаться в длительное изучение комментариев и в их актуализацию. С кодом, в котором много комментариев, часто бывает такое, что сам код меняют, а комментарии остаются старые.
===
Зато! (вы же понимаете, что пропадать количество информации не должно же)
===
Имена классов, методов и структура самих классов должны быть созданы понятно и с соблюдением принципов объектно-ориентированного проектирования и принципов SOLID.
===
Вот тако вот. Воно оно чо. То-то и Кутуньо.
Около минуты
30 ноября 2022