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
- Conference: Write the Docs PORTLAND
- Year: 2018