SE
Когда в EE работал, там код ревью сводилось только к тому, что понятно ревьюеру что происходит или нет ну и банальные требования по код стайлу
Size: a a a
2020 January 09
М
Не понял
Если кода много, а разработчиков мало, шарить все знания не получится
DB
Если кода много, а разработчиков мало, шарить все знания не получится
Почему?
DB
Шаринг знаний это не только про научить кого-то, но и про ведение документации
DB
Для этого больше разработчиков не нужно. У нас линтер был настроен на изменённые файлы и требовал в них документацию всех уровней (модуля-файла-методов-свойств)
AA
ну стараешься дублировать нагрузку по определенному функционалу на разработчиков, типа за эту часть отвечает один, а помогает другой в случае чего (поначалу с простыми задачами)
итоге, потихноьку, улучшаешь басфактор
итоге, потихноьку, улучшаешь басфактор
DB
Мы так постепенно все покрыли документацией
М
ок, не то подразумевал, когда увидел "шаринг знаний"
М
Для этого больше разработчиков не нужно. У нас линтер был настроен на изменённые файлы и требовал в них документацию всех уровней (модуля-файла-методов-свойств)
а она не устаревает?
DB
Устаревает
DB
Но это уже следующий вопрос 🌚
М
ну стараешься дублировать нагрузку по определенному функционалу на разработчиков, типа за эту часть отвечает один, а помогает другой в случае чего (поначалу с простыми задачами)
итоге, потихноьку, улучшаешь басфактор
итоге, потихноьку, улучшаешь басфактор
за любую часть системы минимум два ответственных?
М
Но это уже следующий вопрос 🌚
ну если она устаревает и малополезна, то изначальную проблему не решает, потому что не работает)
М
Когда в EE работал, там код ревью сводилось только к тому, что понятно ревьюеру что происходит или нет ну и банальные требования по код стайлу
вот это и неприятно, что ревью становится поверхностным и не очень полезным в целом
AA
за любую часть системы минимум два ответственных?
если в ней за день не разобраться самостоятельно, то да
ответственность в том числе за докуменатцию как раз, техдолг и пр
на перфоманс ревью потом плюшки за это все.
ответственность в том числе за докуменатцию как раз, техдолг и пр
на перфоманс ревью потом плюшки за это все.
М
если в ней за день не разобраться самостоятельно, то да
ответственность в том числе за докуменатцию как раз, техдолг и пр
на перфоманс ревью потом плюшки за это все.
ответственность в том числе за докуменатцию как раз, техдолг и пр
на перфоманс ревью потом плюшки за это все.
где-то формализуете что такая-то фича/модуль принадлежит конкретным людям?
AA
ага, начинаем как раз этим заниматься (в смысле у нас сейчас как раз ситуация, когда мало разработчиков и много неизвестного почти никому кода)
цели на квартал - разобраться в этом части кода, документацию сделать минимальную, провести лекции для остальных, если сервис взаимодействует с остальным миром
плюс лекции от старожилов обзорные, если знания нужны прямо сейчас, и ждать документацию квартал слишком долго
цели на квартал - разобраться в этом части кода, документацию сделать минимальную, провести лекции для остальных, если сервис взаимодействует с остальным миром
плюс лекции от старожилов обзорные, если знания нужны прямо сейчас, и ждать документацию квартал слишком долго
М
под документацией подразумевается что-то высокоуровневое, верно?
AA
под документацией подразумевается что-то высокоуровневое, верно?
наверное - без примеров тяжело понять, что значит для Вас высокоуровневая документация )
мне кажется, что должно зависеть от контекста, сложности сервиса и количества и типов пользователей.
где-то стоит прояснить историю для разработчиков - почему сделано именно так, а не по-другому (и в 10 раз эффективнее)
где-то в целом рассказать о том, что умеет сервис и что не умеет заказчикам/пользователям
мне кажется, что должно зависеть от контекста, сложности сервиса и количества и типов пользователей.
где-то стоит прояснить историю для разработчиков - почему сделано именно так, а не по-другому (и в 10 раз эффективнее)
где-то в целом рассказать о том, что умеет сервис и что не умеет заказчикам/пользователям
V
Для этого больше разработчиков не нужно. У нас линтер был настроен на изменённые файлы и требовал в них документацию всех уровней (модуля-файла-методов-свойств)
а можно пример как такой линтер не больно создать?