Skip to Content
Buscando SRE
book

Buscando SRE

by David N. Blank-Edelman
October 2024
Intermediate to advanced
590 pages
19h 59m
Spanish
O'Reilly Media, Inc.
Content preview from Buscando SRE

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, ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

AirBnbBlueOriginElectronic ArtsHomeDepotNasdaqRakutenTata Consultancy Services

QuotationMarkO’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
QuotationMarkI wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
QuotationMarkI’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
QuotationMarkI'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Mark W.
Embedded Software Engineer

You might also like

Convertirse en SRE

Convertirse en SRE

David N. Blank-Edelman
Algoritmos en pocas palabras, 2ª edición

Algoritmos en pocas palabras, 2ª edición

George T. Heineman, Gary Pollice, Stanley Selkow
Aprendizaje automático y seguridad

Aprendizaje automático y seguridad

Clarence Chio, David Freeman

Publisher Resources

ISBN: 9798341602083