June 6–8, 2018, Grand Copthorne Waterfront Hotel, Singapore. View the full program at https://www.usenix.org/conference/srecon18asia/program.
Curated by: USENIX (40 videos)
Do Docs Better: Practical Tips on Delivering Value to Your Business through Better Documentation Riona MacNamara, Google 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 View the full SREcon18 Asia/Australia Program at https://www.usenix.org/conference/srecon18asia/program Sign up to find out more about SREcon at https://srecon.usenix.org