Cómo escribir un documento de diseño efectivo
Un buen documento de diseño puede ahorrar años de tiempo de desarrollo. Obliga a pensar decisiones importantes antes de perder tiempo en la implementación incorrecta.
Se debe escribir un documento de diseño cuando el proyecto es complejo o arriesgado, involucra a múltiples personas, dura más de tres meses, implica colaboración entre equipos o tiene requisitos ambiguos.
El documento debe incluir solo decisiones cuyo costo de equivocarse sea alto. Las decisiones triviales, como un botón 'Cargar más', no pertenecen al documento.
Los componentes comunes de un documento de diseño son: título, metadatos, objetivo, antecedentes, objetivos, no-objetivos, escenarios, diagramas, glosario, restricciones, SLOs, monitorización, cronograma, interfaces, dependencias, seguridad, privacidad, consideraciones legales, registro, problemas abiertos, problemas resueltos y alternativas consideradas.
Una vez completado, el documento debe compartirse con el equipo para recopilar comentarios y mover el proyecto hacia adelante.
desarrollo software · documentacion tecnica · gestion proyectos · buenas practicas