EL DESAFÍO DE MANTENER INFORMACIÓN PRECISA SOBRE LOS PROYECTOS
El sitio web de un proyecto puede resultar engañoso cuando su documentación describe funciones que han cambiado o ya no existen.
Los desarrolladores pueden seguir instrucciones desactualizadas, los usuarios pueden malinterpretar las capacidades actuales y los analistas pueden repetir información que antes era correcta, pero que ya no es pertinente.
Los proyectos del ecosistema TRON pueden reducir este problema asignando responsables de la documentación y revisando las páginas importantes cada vez que cambie el comportamiento del producto.
Las notas de lanzamiento deben indicar las diferencias importantes, mientras que las guías técnicas deben especificar claramente los requisitos de versión.
Mantener la información actualizada es un trabajo continuo, no una tarea que se realiza una sola vez al publicar.
La documentación merece la misma atención que el software, porque las personas la utilizan para tomar decisiones técnicas, operativas y, a veces, financieras.
@trondao
@justinsuntron
#TRONEcoStar
El sitio web de un proyecto puede resultar engañoso cuando su documentación describe funciones que han cambiado o ya no existen.
Los desarrolladores pueden seguir instrucciones desactualizadas, los usuarios pueden malinterpretar las capacidades actuales y los analistas pueden repetir información que antes era correcta, pero que ya no es pertinente.
Los proyectos del ecosistema TRON pueden reducir este problema asignando responsables de la documentación y revisando las páginas importantes cada vez que cambie el comportamiento del producto.
Las notas de lanzamiento deben indicar las diferencias importantes, mientras que las guías técnicas deben especificar claramente los requisitos de versión.
Mantener la información actualizada es un trabajo continuo, no una tarea que se realiza una sola vez al publicar.
La documentación merece la misma atención que el software, porque las personas la utilizan para tomar decisiones técnicas, operativas y, a veces, financieras.
@trondao
@justinsuntron
#TRONEcoStar