AK
Yuri Zhloba
Увы, но тут никакие инструменты разработки не помогают.
помогают, самодокументированый код. Немного правильных имен переменных, фукций, модулей, немного комментов. Ссылка на место в доке прямо из кода и вполне все приятно может быть
Size: a a a
2020 February 29
BG
Yuri Zhloba
И проблема понимания кода, это проблема плохой/отсутствующей документации.
На мой взгляд, не стоит сводить проблему понимания кода к плохой документации. Как раз хорошо читаемый код может быть хорошо понят и при плохой документации
YZ
Это вопрос масштаба. До какого-то масштаба код может содержать достаточно информации, чтобы понять систему. А после уже не содержит. И чем больше система, тем больше инфы не хватает в коде.
YZ
Если вы делаете проект в одиночку, то это один масштаб. Если командой в 5-10 человек, то другой. Если подразделением в 200 человек, то третий.
YZ
Команда в 5 человек еще может надеяться, что вся инфа есть в коде. У подразделения в 200 человек такого точно не будет.
YZ
И вот вы открываете в своей IDE код, который писала другая команда, в другой доменной области, на другом языке программирования, и вы вот ни разу не надеетесь, что все поймете из кода.
YZ
Какой бы он там не был гениально структурированный.
TH
Yuri Zhloba
И вот вы открываете в своей IDE код, который писала другая команда, в другой доменной области, на другом языке программирования, и вы вот ни разу не надеетесь, что все поймете из кода.
Это кейс, конечно, жизненный, но скорее исключительный, чтобы его приводить в качестве ориентира
TH
Помимо этого, если у тебя 200 человек пишут код и ты сидишь в их коде, то тут что-то не то с организацией разработки
YZ
Обычно достаточно сходить поговорить. Но бывает, что и код надо посмотреть.
TH
В смысле, что тут должна быть какая-то функциональная делимость между командами
YZ
Но идея не в этом. Идея в том, что код - - это не вся система, это часть системы. И не нужно ожидать, что в коде есть вся необходимая для работы информация.
TH
Для меня обычно тимлиды - "апи" к тому колхозу, который они говнокодят
YZ
"обычно", то есть не всегда :) вот ты сам употребил это слово.
AK
самому смотреть чтобы составить какое то понимание. Это не для серьезной работы с кодом
TH
Не, ну я могу заглянуть под ковёр, что они там прячут, из любопытства, но не как функция человека руководящего.
СИ
В смысле, что тут должна быть какая-то функциональная делимость между командами
смотреть код от 200 человек нормально - возьми любой живой открытый проект
СИ
самому смотреть чтобы составить какое то понимание. Это не для серьезной работы с кодом
эээ.. а для какой?
TH
смотреть код от 200 человек нормально - возьми любой живой открытый проект
Не совсем корректно сравнивать 200 человек, которые что-то законтрибьютили и 200 разрабов, которые каждый рабочий день пилят тонны кода, причем не самого лучшего качества ибо дедлайны
YZ
Впрочем, ладно, если кто-то продолжает верить в самодокументируемый код, то от этого ничего плохого не будет. Может даже будет польза :)