Read the Fantastic Manual: Writing Security Docs People Will Actually Read

Presented at BSidesSF 2022 Rescheduled, June 4, 2022, 2 p.m. (25 minutes).

RTFM: a demand that’s rarely useful for people who need information. How do we know docs are the solution? How can security pros write effectively for those who aren’t? And how can we know if our docs work at all? In this talk, we’ll cover IDing needs, strategic and iterative doc creation, and measuring success.


Presenters:

  • Breanne Boland - Gusto
    Breanne Boland is a product security engineer with the Security Partnerships team at Gusto. Before moving into security, she was a site reliability engineer and an infrastructure engineer who did work in healthcare and govtech. Prior to that, she was a professional writer, and she still considers finishing the docs the real sign that the work is done. She writes fiction and zines, embroiders, makes creatures out of clay, and reminisces about traveling. She lives in Oakland and can be found at twitter.com/breanneboland.

Links: