Do Docs Better: Practical Tips on Delivering Value to Your Business through Better Documentation

Thursday, June 07, 2018 - 4:45 pm5:10 pm

Riona MacNamara, Google

Abstract: 

Missing, incomplete, or stale/inaccurate documentation hurts development velocity, software quality, and—critically—service reliability. And the frustration it causes can be a major cause of job unhappiness.

SREs often spend 35% of their time on operational work, which leaves only 65% for development. Time spent on documentation comes out of the development budget, and this is challenging if there's a perception that creating and maintaining docs is grunge work that may not be recognized or rewarded. To convince fellow engineers and leadership to invest time and resources in documentation, it's essential not only to create good docs, but to gather data that communicates their quality, effectiveness, and value.

Attendees will learn:

  • How to understand and communicate documentation quality
  • Functional requirements for SRE documentation
  • Best practices for creating better, useful documentation
  • How to better communicate the value of documentation work to your business in order to drive change
BibTeX
@conference {214935,
author = {Riona MacNamara},
title = {Do Docs Better: Practical Tips on Delivering Value to Your Business through Better Documentation},
year = {2018},
publisher = {{USENIX} Association},
}