As given at BSidesSF in February 2020, here are my slides and full notes in PDF form to refer to at your leisure. When the talk is added to the BSidesSF YouTube channel in a month, I’ll add that link here too.
I recently gave a 20-minute talk at the Diana Initiative in Las Vegas to help security writers take control of their writing and editing process.
As I’ve started to shift roles from Technical Editor to Technical Marketing Writer this year, I wanted to pass on the practical advice I’ve learned in the last 3 years to the security writers in the industry who don’t have the benefit of editors on call like the consultants at Bishop Fox do.
My slides and notes from the presentation are attached as a PDF:
Chaos in the Machine: Why Security Needs a Style Guide: https://youtu.be/Yl-4BWKpC28 (My 20 minute CactusCon talk about the benefits of choosing language intentionally)
Ze Frank: An Invocation for Beginnings (start writing now!)
Other Notes:
Use bullet points to clean up sentences with long lists. (They also trick readers into reading more than they would.)
Only capitalize nouns that deserve it. (Just because it’s part of an acronym doesn’t mean you need to show where the acronym comes from.)
Watch out for -ing words. Going, accessing, uploading… these words can be nouns or verbs, so they are often the cause of confusion in a sentence. Seek them out and see if you can rephrase to use a stronger form (go, access, upload).