12 093 метода из 19 880 в моём проекте — ни одного комментария. Покрытие документацией — 39%. Это не чужой легаси-код. Это мой собственный проект, который я пишу прямо сейчас. Я направил свой инструмент на самого себя и увидел то, от чего у любого техлида дёргается глаз: кодовая база растёт быстрее, чем документация. 1183 файла […]
В какой-то момент я прогнал самоаудит по своему проекту и получил неприятную, но полезную картину. В кодовой базе оказалось 41 034 метода и 2 170 файлов. Если считать только основной код, без тестов, 12 093 метода из 19 880 были вообще без комментариев. Покрытие документацией получилось 39%. Это не история про чужой легаси-проект. Это мой текущий код. Он просто […]
Всем привет! Меня зовут Александр, я COO в SaaS-платформе аналитики данных. Делюсь полезными материалами, которые считаю стоят внимания. В основном про AI, изменение процессов, тренды и продуктовое видение. У себя в телеграм-канале делюсь сжатыми и структурированными саммери статей. Сегодняшний перевод статьи разработчика, в которой хорошо подмечены проблемы применения LLM в разработке. На протяжении многих лет […]