Creo con cualquier documentación que el enfoque ágil es bueno. Ahora, hay algunos conceptos erróneos que ágil significa "no hay documentación o análisis en absoluto", pero ese no es el caso. Las cosas que he leído sobre ágil dicen: "usa lo que funciona". Supongo que significa que el documento debe ser extenso y detallado en proporción a la tarea.
Las plantillas pueden ser útiles como una lista de verificación, pero no requeriría que se completen todas las secciones para cambios pequeños o de bajo riesgo. Para un cambio de una línea, tal vez no necesite un documento en absoluto. Nunca he usado una plantilla para un documento de análisis de impacto, pero regularmente trato con requisitos comerciales o especificaciones técnicas. Una plantilla puede ser demasiado restrictiva; una buena pauta es considerar quién será la audiencia Si se trata de gerentes que no son técnicos, concéntrese en la justificación comercial del cambio. Si se trata de personas técnicas, proporcione un poco de información para que una nueva persona en el equipo no se pierda y bríndeles lo suficiente para ponerse en marcha si tienen que apoyar el cambio. Además, si quieres algo aún más liviano y sin fricción, no uses un documento, ponlo en un wiki.
Información a incluir:
- Breve descripción del problema
- Explicar o mostrar un ejemplo de cómo el defecto está causando falla y / o ineficiencia
- Incluir estimación de complejidad
- Incluya una estimación del costo y el tiempo de reparación
Eso es un mínimo decente. La otra publicación destacó algunas cosas bastante pesadas de CMMi de IBM; eso es genial si tienes el tiempo y los recursos para ello (y cuando estás construyendo sistemas para la NASA donde la vida humana está en juego, entonces es mejor que la gente se lo tome en serio), pero para equipos pequeños probablemente no necesites ser tan pesado . Tenga cuidado con la estimación, como siempre. Los gerentes tienden a suponer que una estimación es la real.
Tenga en cuenta que hay peligros en el enfoque ágil. Algunos desarrolladores piensan que significa "no se necesitan documentos, simplemente comience a hackear" (lo cual podría estar bien en algunas situaciones). Además, otros tomarán la libertad dada la tarea y simplemente escribirán documentos realmente malos que realmente no ayudan (no necesariamente en la mayoría de las situaciones). Parte del problema es que escribir bien requiere algo de esfuerzo, habilidad y tiempo; la mayoría de nosotros nos faltan al menos dos de esas cosas;)
Siempre me ha gustado la documentación porque demuestra que al menos has pensado lo suficiente como para tener un plan. Pero en mi vejez también he llegado a apreciar que demasiada documentación puede convertirse en una molestia de mantenimiento, y que no hay suficientes personas que se preocupen lo suficiente como para mantener la documentación actualizada.