Capítulo 19. Hacer mejor los documentos: Integrar la documentación en el flujo de trabajo de ingeniería
Este trabajo se ha traducido utilizando IA. Agradecemos tus opiniones y comentarios: translation-feedback@oreilly.com
En toda la industria del software, la confianza en la documentación de ingeniería es baja. La encuesta de desarrolladores de Stack Overflow de 2016 clasificó la documentación como el segundo reto al que se enfrentan los desarrolladores.
Esto es un problema. La documentación ausente, incompleta, obsoleta o inexacta perjudica la velocidad de desarrollo, la calidad del software y, lo que es fundamental para las SRE, la fiabilidad del servicio. Y la frustración que genera puede ser una causa importante de infelicidad laboral para los desarrolladores.
La documentación requiere tiempo y esfuerzo, y esto es especialmente difícil para los SRE. Los SRE suelen dedicar el 35% de su tiempo al trabajo operativo, lo que deja sólo el 65% para el desarrollo. El tiempo dedicado a la documentación debe salir del presupuesto de desarrollo, y esto es difícil si existe la percepción de que crear y mantener la documentación es un trabajo sucio que puede no ser reconocido o recompensado durante los procesos de revisión del rendimiento y promoción.
¿Cómo se puede cambiar esto? ¿Cómo puedes hacer que tu organización comprenda el valor de la documentación de ingeniería, ...
Get Buscando SRE now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
