Creating a style guide from scratch can feel overwhelming.
While you certainly can create your own style guide from scratch, here are some ways to help you create a style guide faster and with less stress.
Don't want to think too much about your style guide? We've created a template covering the most common style guide elements. Copy and paste what you need and adapt it to fit your needs.
Voice and tone
- Voice: Friendly, professional, and clear.
- Tone: Supportive and helpful. Avoid jargon where possible.
- Use active voice (e.g., "Click the button" instead of "The button should be clicked").
Writing style
- Write in short, concise sentences.
- Use plain language whenever possible.
- Explain acronyms and abbreviations the first time they appear.
- Use consistent terminology.
Formatting and structure
- Headings:
- Use clear, descriptive headings.
- Use sentence case (e.g., Configuring your account).
- Paragraphs: Keep paragraphs short (2–4 sentences)
- Lists:
- Use bullet lists for options and steps.
- Use numbered lists for sequences.
- Links: Embed links in descriptive text (Learn more about billing settings).
Terminology
- Refer to your product or service consistently by its proper name.
- Use customer-centric language (e.g., "you" and "your" instead of "the user").
- Example terms (customize as needed):
- Sign in instead of log in
- Account settings instead of user preferences
- Help Center instead of knowledge base
Capitalization and punctuation
- Use sentence case for headings.
- Capitalize product names and feature names.
- Use the Oxford comma in lists.
- Avoid exclamation points unless celebrating something (Congratulations!).
Screenshots and images
- Use clear, high-resolution images.
- Crop images to focus on relevant areas.
- Add captions where helpful.
- If including steps, highlight the UI elements.
Examples and code
- Format code snippets in monospace font.
- Use consistent indentation.
- Provide example outputs.
Accessibility
- Use alt text for all images.
- Avoid color as the only means of conveying information.
You can also search for other style guide templates that might work well for you.
Thursday Bram has a nice template available in .docx format on her blog, available at: Download My In-House Style Guide Template to Use However You Want or as a Google Doc you can copy.
This is one of the fastest and most powerful approaches. Tell Owl Intelligence to follow an established style guide, then document only your exceptions or additions
For example, use something like the Google developer documentation style guide as a base. Then add style guide details for any specific additions or exceptions to that guide you'd like to use.
Your style guide might say:
Follow the Google developer documentation style guide.
Exceptions: Use "Help Center" instead of "knowledge base"; write out numbers one through nine instead of using numerals (1-9); use "email" as both a noun and verb (not "e-mail"); always capitalize "Internet."
Another example prompt:
Follow the Microsoft Writing Style Guide.
Exception: Use title case for all headings instead of sentence case (e.g. "Getting Started With Your Account" instead of "Getting started with your account").
The AI model that Owl Intelligence uses is already trained on many major style guides, so you don't need to copy and paste their full content—you can just reference them by name and note where your organization differs.
Commonly recognized style guides:
We built Owl Intelligence to recognize these major style guides:
- Google developer documentation style guide
- Google's Material Design Style guide
- Microsoft Writing Style Guide
- Apple Style Guide
- Chicago Manual of Style
- Associated Press Stylebook
Let us know if there's a common style guide we should include!
For more guidance on creating effective style guides, check out these resources:
- The Write the Docs Style Guides page.
- A Write the Docs Portland 2021 talk: Deanna Thompson - Building a style guide from the ground up: lessons learned from a lone writer