Итак, я углубился в эту тему, и это безумие, как мало я знал о практиках и рамках документации, и это никогда не упоминается в реальных документах или в чем-то, о чем вы увидите большие курсы. arc42, моделирование C4, Diátaxis — это подходы, которые я никогда не видел, чтобы люди явно практиковали. Большинство кодовых баз, которые я видел, имели очень произвольную документацию, созданную как после мысли, или, с другой стороны спектра, были полностью упрощены и абстрагированы опытными техническими писателями, так что было невозможно понять сложность продукта под самой поверхностью. Сказав это, я сейчас работаю над собственным инструментом для агентной документации, который должен применить некоторые из этих практик и поддерживать последовательные документы для высокоскоростных кодовых баз и быть совместимым с любыми видами рабочих процессов разработки, с возможностями обрабатывать целые репозитории с нуля и поддерживать их позже, обрабатывая git diffs произвольного происхождения.