Архив рубрики ‘онбординг разработчиков’

41 034 метода, 2 170 файлов: как я перестал быть единственным источником знаний о коде

12 093 метода из 19 880 в моём проекте — ни одного комментария. Покрытие документацией — 39%. Это не чужой легаси-код. Это мой собственный проект, который я пишу прямо сейчас. Я направил свой инструмент на самого себя и увидел то, от чего у любого техлида дёргается глаз: кодовая база растёт быстрее, чем документация. 1183 файла […]

Когда код растёт быстрее документации

В какой-то момент я прогнал самоаудит по своему проекту и получил неприятную, но полезную картину. В кодовой базе оказалось 41 034 метода и 2 170 файлов. Если считать только основной код, без тестов, 12 093 метода из 19 880 были вообще без комментариев. Покрытие документацией получилось 39%. Это не история про чужой легаси-проект. Это мой текущий код. Он просто […]