Loading…
Agiles 2019 has ended
MUCHAS TRIBUS, UNA MISMA AGILIDAD

Sitio oficial: http://agiles2019.agiles.org/
Twitter: @agilesla
Facebook: @agileslatam
Instagram: @agileslatam
Hashtags del evento: #agilesLatam #agiles2019
Back To Schedule
Friday, September 20 • 13:00 - 13:45
PEDIDO: Agilidad y documentación

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

Feedback form is now closed.
Regulaciones- Compliance. PROCESOS

Contrario al pensamiento de algunos, en la Agilidad si se documenta.

En el Manifiesto Ágil para el Desarrollo de Software está claramente definido que valoramos más el "Software funcionando sobre documentación extensiva", y también se hace énfasis en que "aunque valoramos los elementos de la derecha, valoramos más los de la izquierda".

Finalmente lo que define documentación que se debe o no construir para cualquier software es el valor que está documentación generará:
  • Dejar anotaciones en el código para los desarrolladores y testers ahorrarán el suficiente tiempo a la hora de comprender el código.
  • El manual de usuario permitirá que el conocimiento de la funcionalidad completa sea transmitido, sin perder algunas funciones "que casi nadie utiliza"
  • Los diagramas técnicos de arquitectura y elementos de infraestructura son vitales para el correcto mantenimiento.
Así mismo, existe un caso en el que, aunque el desarrollador siente que está perdiendo su esfuerzo, genera valor al negocio: la documentación exigida por el negocio o por la ley.

A los desarrolladores no nos gusta documentar. No nos gusta generar más documentación que la que podemos comprender. Si no comprendernos el beneficio que generará, la vernos como un peso que no queremos cargar. Pero para una empresa, por ejemplo para un banco, la legislación puede exigir alguna documentación que, de no cumplirse, podría generar cobro de multas. Está documentación, a los ojos de un desarrollador, podría ser considerada inútil, y por ello, el desarrollador podría decidir no construirla y volcar todo si esfuerzo en construir software funcional (pues si lo dice el manifiesto, ¿no?).

Es importante que todos los integrantes de la cadena de producción de software estén enterados de la importancia y del valor generado de cada documento que se requiere crear (o del valor que se perdería de no generarla).

Y para cerrar, aunque valoramos más el software funcional sobre la documentación, la legislación siempre estará por encima de todo lo demás.

Ciudadanos
avatar for Daniel Ramírez

Daniel Ramírez

Desarrollador full-stack / Scrum Master / Ingeniero de Sistemas, TCS
DevOps, Scrum, SAFe, TDD, cualquier tema que resulte interesante! Desarrollador Full-stack, más de 20 años desarrollando, más de 5 años en el agilismo. Ingeniero de Sistemas, Master en Business Intelligence.
SJ

saraybel jiménez

COE Procesos, Banco Galicia


Friday September 20, 2019 13:00 - 13:45
07-Esteros del Iberá (Negro)

Attendees (6)