Así que me metí en este agujero de conejo y es increíble lo poco que sabía sobre las prácticas y marcos de documentación, y nunca se menciona en documentos reales ni en algo que verás en grandes cursos. arc42, modelado C4, Diátaxis son enfoques que nunca he visto que la gente practique explícitamente. la mayoría de las bases de código que he visto tenían documentación muy improvisada construida como un pensamiento secundario o, como otro extremo del espectro, habían sido completamente simplificadas y abstraídas por redactores técnicos experimentados, por lo que era imposible captar la complejidad del producto bajo la superficie. Dicho esto, ahora estoy trabajando en la propia herramienta de documentación agente, que debería aplicar algunas de estas herramientas en la práctica y mantener documentos consistentes para bases de código de alta velocidad y ser compatible con cualquier tipo de flujo de trabajo de desarrollo, con posibilidades de procesar repositorios enteros desde cero y mantenerlos más adelante procesando git diffs de origen arbitrario.