Technology Radar
Escribir buena documentación es un aspecto que se pasa por alto en el desarrollo de software y que suele dejarse para el último momento y se realiza de manera desordenada. Algunos de nuestros equipos han encontrado en los cuadrantes de documentación una manera práctica de garantizar que se produzcan los artefactos correctos. Esta técnica clasifica los artefactos sobre dos ejes: El primer eje está relacionado con la naturaleza de la información, práctica o teórica; el segundo eje describe el contexto en el que el artefacto es usado, estudiado o trabajado. Esta técnica define cuatro cuadrantes en los cuales artefactos como tutoriales, guías prácticas o páginas de referencia pueden ser clasificadas y entendidas. Este sistema de clasificación no solo asegura que artefactos críticos no sean pasados por alto sino que también guía la presentación del contenido. Hemos encontrado esto particularmente útil a la hora de crear documentación de onboarding que facilita la rápida puesta al día de nuevos desarrolladores cuando se unen a un nuevo equipo.
