Alors, je suis tombé dans ce terrier de lapin et c'est fou comme je savais peu de choses sur les pratiques de documentation et les cadres, et tout cela n'est jamais mentionné dans les docs réelles ou dans des cours importants. arc42, la modélisation C4, Diátaxis sont des approches que je n'ai jamais vraiment vues pratiquées explicitement par les gens. La plupart des bases de code que j'ai vues avaient une documentation très ad hoc construite comme une réflexion après coup ou, à l'autre extrême, ont été complètement simplifiées et abstraites par des rédacteurs techniques expérimentés, rendant impossible la compréhension de la complexité du produit sous la surface. Cela dit, je travaille maintenant sur mon propre outil de documentation agentique, qui devrait appliquer certaines de ces pratiques et maintenir des docs cohérents pour des bases de code à haute vélocité et être compatible avec tous types de flux de développement, avec des possibilités de traiter des dépôts entiers depuis le début et de les maintenir ensuite en traitant les diffs git d'origine arbitraire.