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.
Speak volumes.
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:
Cybersecurity Style Guide: https://cybersecuritystyleguide.com
Cyberdic (Spellcheck augmenter) https://github.com/bishopfox/cyberdic
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)
AP Style: https://www.apstylebook.com/
BuzzFeed Style Guide: https://www.buzzfeed.com/emmyf/buzzfeed-style-guide
Conscious Style Guide: https://consciousstyleguide.com/
How to Name Files: https://speakerdeck.com/jennybc/how-to-name-files
It Was the Best of Sentences, It Was the Worst of Sentences by June Casagrande https://www.goodreads.com/en/book/show/40717966-it-was-the-best-of-sentences-it-was-the-worst-of-sentences
Lawyerist: How to Redact a PDF: https://lawyerist.com/how-to-redact-a-pdf/
Lifehacker: Should You Use Grammarly Anymore? https://lifehacker.com/should-you-use-grammarly-anymore-1833585995
Writing Tools: 50 Essential Tools for Every Writer by Roy Peter Clark https://www.goodreads.com/book/show/51750.Writing_Tools
Ze Frank: An Invocation for Beginnings (start writing now!)
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).
Self-made Lexicographer: How I Compiled a Cybersecurity Style Guide
When I joined the information consulting firm Bishop Fox as a technical editor three years ago, I had trouble finding definitive answers for questions about pronunciation, near synonyms, and font choices. It was difficult to edit without knowing what to turn to for authoritative answers. I started building out a list of tricky terms, and in 2 years that list grew into a style guide. I’ve always loved and used reference works, but through creating a new one from scratch, I have become more aware of (and very sympathetic to) lexicographer-specific problems. Through creating a style guide for my company, I learned to consider the huge consequences of decisions like how to alphabetize, what to cross-reference, and how to decide when a style guide is “done.”
When I joined the information consulting firm Bishop Fox as a technical editor three years ago, I had trouble finding definitive answers for questions about pronunciation, near synonyms, and font choices. It was difficult to edit without knowing what to turn to for authoritative answers. I started building out a list of tricky terms, and in 2 years that list grew into a style guide. I’ve always loved and used reference works, but through creating a new one from scratch, I have become more aware of (and very sympathetic to) lexicographer-specific problems. Through creating a style guide for my company, I learned to consider the huge consequences of decisions like how to alphabetize, what to cross-reference, and how to decide when a style guide is “done.”
Cybersecurity terms blend together corporate jargon, military slang, and internet memes, and this style guide reflects that composition. By listing them alphabetically, this guide recreates the feeling of being in an infosec conversation – One minute it’s ransomware and Raspberry Pi, the next it’s rickrolling and Rule 34.
Come learn how developing a spelling bee from the word list influenced its most recent form, how DSNA Barbados helped me make an intentionally compassionate reference work, and what changed after I received early feedback from more established lexicographers.
I am proud to have compiled a resource that editors and lexicographers can point to in the future when they look to track the spread of niche terminology, and so glad to provide security writers with a daily resource that accurately represents their industry.
Self-made Lexicographer: How I Compiled a Cybersecurity Style Guide will happen at the Dictionary Society of North America 22 conference on Wednesday, May 8, 2019 at 4pm.
It was a big year for the style guide! I gave one talk, released two versions, hosted three spelling bees, and was written up in 7 articles and interviews.
The revised Version 1.1 is out now! Go get it here in PDF form: cybersecuritystyleguide.com.
V2 of the #SecurityStyleGuide is in the hopper right now, but until it is released, let’s take a look back on the year that belonged to the #SecurityStyleGuide:
February 15: Version 1 Released
Hello World! Introducing the Bishop Fox Cybersecurity Style Guide
February 23: The Parallax Interview
Cybersecurity Style Guide helps you write like a hacker
February 24: Wired Article
Web Semantics: The Bishop Fox Cybersecurity Style Guide
February 24: BoingBoing Article
March 1: Spoke at SOURCE Mesa
“Security Needs a Style Guide and Here’s V1”
March 2: Sentence First Article
Cybersecurity Style Guide is a useful editing tool
March 2: CSO Article
New Cyber Security Style Guide helps bridge the communication gap
March 15: Alien Vault Interview
Infosec Language Grows Up: The Bishop Fox Cybersecurity Style Guide
May 15: Chicago Manual of Style Shop Talk Blog Interview
Brianne Hughes talk about the Cybersecurity Style Guide
May 30: Spoke at Bay Area OWASP meeting about the Style Guide
June 27: Version 1.1 Released
Reintroducing the Cybersecurity Style Guide: V1.1
Summary of updates: 200+ new entries, most have been revised, most have parts of speech, new guidance on using progressive terms,
June 28: Beta version of SpellCheck at the Bishop Fox Tempe offices
SpellCheck Spelling Bee rules!
July 20: Circle of HOPE SpellCheck
You can download the video of the spelling bee from HOPE!
More info at #HOPESpellCheck on Twitter
August 11: DEF CON SpellCheck
More info at #DEFCONSpellCheck on Twitter
SpellCheck at HOPE:
Friday July 20 at 11:59 PM in the Booth Ballroom on the 18th floor
Sign up in person at the Info Desk, starting at 10am on Friday.
https://hope.net/schedule.html
https://www.bishopfox.com/news/2018/06/the-circle-of-hope-spellcheck-the-hacker-spelling-bee/
SpellCheck at DEF CON:
Saturday August 11 at 3:00 PM in the Contest Stage at Caesars on the Emperor’s floor
Sign up in advance via email starting August 1st through style@bishopfox.com.
https://www.defcon.org/html/defcon-26/dc-26-contests-events.html
You may have noticed from my #AmEditing and #StyleGuide tweets that I’ve been working on a big project for two years between my billable work as a technical editor for Bishop Fox. I am very pleased to announce that Version 1 of the resulting security style guide is available to you as a free PDF starting today.
We’re already thinking about how to improve things for Version 2, so if you’d like to add to that conversation, please email your suggestions to style@bishopfox.com
https://www.bishopfox.com/blog/2018/02/hello-world-introducing-the-bishop-fox-cybersecurity-style-guide/