A los que piensan que documentar es la solución…

jgarzas_233_documentar_codigo_desarrollo_software

4 comentarios en “A los que piensan que documentar es la solución…”

  1. ¿Tener un readme.md en condiciones es documentar?
    ¿Invertir en que el swagger de tu API Rest tenga comentarios y ejemplos es documentar?
    Para mí sí. A lo mejor lo que hay que hacer es cambiar el estilo y soporte de la documentación.

    1. La documentación debe tener en cuenta al destinatario posible de la misma.
      Estoy participando de un proyecto muy grande con un mix de equipos y proveedores y no todos trabajan con AGILE. Mas alla de ello, la interacción de diferentes equipos interdependientes requieren de cierto grado de documentación. Por ejemplo, cuando se crean o modifican atributos de una base de datos, es necesario que se documente que se modificó, de otra manera es imposible que el resto de los equipos sepan y adecúen sus desarrollos para contemplar estos cambios.

  2. ME encanta tu blog, estás siempre muy acertado: Si bien en este caso, creo que con la documentación aplica como con el budismo … en el medio está la virtud

  3. Francisco Toscano Morales (DSN)

    yaaa
    para documentar es preciso por defecto tener muchos libros en tu base de conocimiento, documentar es uno de los patrones de diseño más antiguos en el ADN humano del cual se desprende el lenguaje y el proceso de abstracción, claro solo es nuestra humilde opinión como DSN_XP

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

Share This
Ir arriba