#понимание_кода — Public Fediverse posts

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

12 093 метода из 19 880 в моём проекте — ни одного комментария. Покрытие документацией — 39%. Это не чужой легаси-код. Это мой собственный проект, который я пишу прямо сейчас. Я направил свой инструмент на самого себя и увидел то, от чего у любого техлида дёргается глаз: кодовая база растёт быстрее, чем документация. 1183 файла на Python. 480 коммитов за полгода. 21 аналитический сценарий, которые я наваял за это время. А документация покрывает меньше половины. Новый разработчик приходит в проект, открывает src/workflow/scenarios/audit_composite.py — а там 6318 строк, 114 вызовов в другие модули, цикломатическая сложность 80. И задаёт первый вопрос: «Кто мне объяснит, как это работает?» Раньше ответ был: «Спроси Мишу». Теперь — запрос к графу свойств кода. И я наконец-то могу заниматься своей работой, а не быть живой документацией.

https://habr.com/ru/articles/1012086/

#онбординг_разработчиков #граф_кода #навигация_по_кодовой_базе #понимание_кода

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

12 093 метода из 19 880 в моём проекте — ни одного комментария. Покрытие документацией — 39%. Это не чужой легаси-код. Это мой собственный проект, который я пишу прямо сейчас. Я направил свой инструмент на самого себя и увидел то, от чего у любого техлида дёргается глаз: кодовая база растёт быстрее, чем документация. 1183 файла на Python. 480 коммитов за полгода. 21 аналитический сценарий, которые я наваял за это время. А документация покрывает меньше половины. Новый разработчик приходит в проект, открывает src/workflow/scenarios/audit_composite.py — а там 6318 строк, 114 вызовов в другие модули, цикломатическая сложность 80. И задаёт первый вопрос: «Кто мне объяснит, как это работает?» Раньше ответ был: «Спроси Мишу». Теперь — запрос к графу свойств кода. И я наконец-то могу заниматься своей работой, а не быть живой документацией.

https://habr.com/ru/articles/1012086/

#онбординг_разработчиков #граф_кода #навигация_по_кодовой_базе #понимание_кода

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

12 093 метода из 19 880 в моём проекте — ни одного комментария. Покрытие документацией — 39%. Это не чужой легаси-код. Это мой собственный проект, который я пишу прямо сейчас. Я направил свой инструмент на самого себя и увидел то, от чего у любого техлида дёргается глаз: кодовая база растёт быстрее, чем документация. 1183 файла на Python. 480 коммитов за полгода. 21 аналитический сценарий, которые я наваял за это время. А документация покрывает меньше половины. Новый разработчик приходит в проект, открывает src/workflow/scenarios/audit_composite.py — а там 6318 строк, 114 вызовов в другие модули, цикломатическая сложность 80. И задаёт первый вопрос: «Кто мне объяснит, как это работает?» Раньше ответ был: «Спроси Мишу». Теперь — запрос к графу свойств кода. И я наконец-то могу заниматься своей работой, а не быть живой документацией.

https://habr.com/ru/articles/1012086/

#онбординг_разработчиков #граф_кода #навигация_по_кодовой_базе #понимание_кода

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

12 093 метода из 19 880 в моём проекте — ни одного комментария. Покрытие документацией — 39%. Это не чужой легаси-код. Это мой собственный проект, который я пишу прямо сейчас. Я направил свой инструмент на самого себя и увидел то, от чего у любого техлида дёргается глаз: кодовая база растёт быстрее, чем документация. 1183 файла на Python. 480 коммитов за полгода. 21 аналитический сценарий, которые я наваял за это время. А документация покрывает меньше половины. Новый разработчик приходит в проект, открывает src/workflow/scenarios/audit_composite.py — а там 6318 строк, 114 вызовов в другие модули, цикломатическая сложность 80. И задаёт первый вопрос: «Кто мне объяснит, как это работает?» Раньше ответ был: «Спроси Мишу». Теперь — запрос к графу свойств кода. И я наконец-то могу заниматься своей работой, а не быть живой документацией.

https://habr.com/ru/articles/1012086/

#онбординг_разработчиков #граф_кода #навигация_по_кодовой_базе #понимание_кода

[Перевод] Почему LLM снизили стоимость кода, но не ускорили разработку

LLM позволяют генерировать рабочий код быстрее, чем когда-либо, но команды разработчиков не ускорились. Стоимость понимания, тестирования и доверия к коду выросла, а традиционные узкие места — код-ревью и координация — стали еще более критичными.

https://habr.com/ru/articles/928636/

#разработка #code_review #llm #искусственный_интеллект #командная_работа #тестирование #понимание_кода #программирование #качество_кода