Skip to main content
U.S. flag

An official website of the United States government

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Style guides

We often develop project-specific style guides to support our partners and their audiences. We usually call these documents content guides, because most of our partners already follow a style guide like AP, GPO, or Chicago.

Guidelines

Here are a few things to keep in mind when you’re developing style guides:

Respect the partner’s existing style. Assume that your partner has an agency-level style guide and ask about it.

  • If they don’t have a style guide, start with AP since we’re most familiar with it and many of our partners use it.
  • If any of the existing style guidelines inhibit clarity or usability, talk with the partner about it, backing up your recommendations with insights from user research.

Keep it brief. Don’t try to document every possible grammatical or style issue. Keep your guide short and sweet so it’s easy for people to reference. Most of our guides include:

  • High-level notes about voice and tone
  • Usage guidelines
    • Acronyms and abbreviations
    • Capitalization
    • Numbers
    • Punctuation
    • Web styling, such as headers or glossary terms
  • Specific words and phrases

Focus on what’s new or particularly unique. If you’re using sentence case or avoiding acronyms, for example, call that out and include inline examples. If you need to use specific terms or technical jargon with users, include suggested phrasing to help other writers follow along.

Share and refine it. Post the guide on a wiki or in a pattern library with other project documentation — don’t bury it in a PDF. Make it easy for people to find and update the guidelines as questions come up.

Examples

18F Content Guide

An official website of the GSA’s Technology Transformation Services

Looking for U.S. government information and services?
Visit USA.gov