Contribute Media
A thank you to everyone who makes this possible: Read More

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

Description

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

Details

Improve this page