What They Don’t Tell You About Creating New Style Guides


Style guides are a key tool for many documentarians — they guarantee consistency, streamline onboarding, and even improve the documentation non-technical writers create.

Whether you're creating an internal style guide or a commercially available reference, though, there are plenty of pitfalls. In this talk, we'll cover:

  • style guide assumptions (and how to avoid them)
  • jargon, slang, idioms, and other words with multiple meanings
  • inclusion, sensitivity readings, and generally making sure you know how other people hear terms
  • teaching style across a team

  • Conference: Write the Docs PORTLAND
  • Year: 2018

About the speaker

Thursday Bram