Вопрос к отцам 😎 представим, что есть некий продукт, над

которым работала команда. И со временем эта команда меняется, приходят новые люди.

Какие есть подходы к экстракции знаний из головы уходящего разработчика?

Я вижу, что должен быть высокоуровневое описание подхода, чтобы можно было понять общий дизайн системы и основные ее функции. Это ясно. Но вот как быть с остальными уровнями.

Нужно что-то вроде ивент сорсинга ровести или домен сторителлинга чтобы сохранить детали и контекст.

Ну и на нижнем уровне rdoc с описанием почему написан этот класс и как и где он используется.

Есть что еще добавить?

Ну тут все за все хорошее против всего плохого, по этому будут тебе советовать логику юмл диаграммами рисовать и закреплять в конфлюенсе словами и картинками, названия методов, аргументов, классов делать такими, чтоб с первого взгляда стало ясно зачем они, пару строк чюулменьариев черкануть чтоб еще сильнее было ясно, но мы все знаем, и я тебе советую просто в голове все держать, чтоб компания стремилась тебя уволить

Я в общем то сейчас как раз этим и занимаюсь. Рисую ЮМЛ, и даже выяснил, что Гитхаб умеет редкрить эти диаграммы.

Доку вести, диаграммы и прочее, но, имхо, это не эффективно. Переходя на новый проект, я эти доки, созданные разрабами, хочу уничтожить :) в итоге проще через тз и код изучить

А от чего именно подгорает? Я часто слышу такое, что мы не делаем доку потому что не хотим ее поддерживать. Но по факту профита от этой экономии нету.

Те же ER-диаграммы и C4 актуальны только на момент разработки проекта и показывают лишь то, как задумывался проект изначально, а все эти подводные камни и решения, принятые, потому что другого выхода не было - нигде не задокументированы)

Ну больше всего подгорает с того что все разрабы на отвали создавляют доку - в их голове они логичная и структурированая, а по факту текст несвязный 😅

Тесты

Ха, вот это поворот. То есть только тестов достаточно, все остальное можно выбросить?

Нет

Не вижу чтобы там было написано что остальное надо выбросить

Тесты есть, конечно можно еще дописать сверху.

Ок, действительно я про наличие тестов не писал, посчитал это само собой разумеющимся.

Хорошие тесты и хотябы чтобы bin/setup проходил видел последний раз в 14-м

Проходит, дело в том, что это не монолит, и все растащено по сервисам.

bin/setup и docker 🤨

Докер работает, если кто-то хочет в нем работать.

По моему докер уже практически обязателен, непонятно зачем без него работать.

Опять про этот докер 🙈

что значит опять? 😃 все равно что говорить "опять этот linux" когда у всех на проде linux

Ох, столько нытиков встречал - для которых это все сложно и они гигантские проекты запускают по 30 минут каждое утро)

легаси же

что легаси? на легаси докер не натянуть?

если не понятно как вообще запустить - да

если тебе непонятно как запустить то ты и на хостовой ОС не запустишь

так бывает

что именно? ты либо можешь запустить на хостовой ос и в докере, либо ни там ни там.

ну и ни там и ни там сидшь разбираешься чего не хватает

Ага. Проще это правда делать в чистом воспроизводимом окружении ))