dab2,

Может лучше начать с описания проблем, задач, контекста?

dab2,

Если у вас хорошо и правильно откомментированный код, то вы можете сгененировать документацию к публичным интерфейсам, методам, контрактам.

Если у вас есть публичные АПИ методы и они также имеют документацию, то вы можете генерировать OpenAPI спецификацию.

Если у вас все в БД все таблицы имеют комментарии, хорошую и правильную нормализацию, то вы можете получить схему БД в физическом и логическом видах. Или соответствующие модели имеют комментарии, из которых можно получить описание моделей, можно получить соответствующие диаграммы.

Если архитектура у вас найс, то учитывая вышеописанное, вы можете получить сгенерированную доку по логике процессов и архитектуре.

Ну и если кто-то вам рассказывает, что комментарии в коде это для лохов, какие-то идиотские истории про "самодокументированный" код и про что-то там "самодокументированное", просто плюньте этим товарищам в лицо.

Потому что, если у вас всего этого нет, но вам это нужно, то либо придётся пускать пыль в глаза и на коленке изобретать какую-то бесполезную фигню для отвода глаз, либо выделить серьёзные ресурсы и много времени на документирование всей системы, ну и на актуализацию, соответственно -- в процессе разработки.