Customer Support

Grammar Standards

From the document "Grammar Standards for Xcel Energy Websites" Version 04 published October 11, 2016 by Andrew Zimmerman

A website that implements its design standards in a consistent manner is more likely to be considered “user friendly” than one that inconsistently applies design standards1. Design standards include copy and content formatting.

This section proposes web copy and user interface element format rules. These rules complement the standards provided in Xcel Energy’s 2016 Brand Standards document2. Applying these rules should result in a consistent experience for website users.

Writing Style & Capitalization

Writing Style

Copy should be written in a deliberative manner but use a simple, direct, and conversational tone. Avoid jargon or buzzwords. Unclear labelling or instructions can confuse users. Ensure copy isn't too long. Copy should be clear, concise, and use natural language.

Sentence Case

Capitalize only the first letter of data labels unless a word used in the data label otherwise deserves capitalization, like proper names, abbreviations, etc. The following user interface elements should use sentence case capitalization:

  • Page title subheading
  • Radio button labels
  • Checkbox labels
  • Button labels
  • Call-to-action labels
  • Hint text
  • Help text
  • List item text

Title Case

Use English title capitalization rules for titles by capitalizing the first letter of each word on web pages and web parts. The following user interface elements should use title case capitalization:

  • Page title
  • Page section heading
  • Form section titles
  • Table captions
  • Table headers and subheaders
  • Dialog titles
  • In-campaign CTAs

Exceptions

The English language is full of exceptions. For attribute values that indicate the property or data field hasn’t been set, or the location is intentionally left empty, use the non-capitalized words or phrases such as “empty”, “none”, “not set”, “unassigned”, or “no alerts”. Some specific words and acronyms are always capitalized for branding or common industry recognition. Examples:

  • VLAN
  • IPv4
  • IPv6
  • WAN

Date and Time, Numbers, & Oxford Comma

Date and Time

Date and time formats should generally be displayed in the user's local time zone. Any exceptions to this should include the timezone being used to display the time and date. In addition, dates and times shall always be localized to use the most recognizable format for the user's locale. Use words like "Today" and "Yesterday" as it doesn't force the user to remember today's date to process the information.

Here are examples of recommended date and time formats. In each of these examples, showing seconds is optional:

  • Today, since 12:00 a.m. today:
    • Today <HH:MM[:SS] a.m. / p.m>.
    • Today 10:10:05 a.m.
    • Today 11:11 a.m.
  • Yesterday, since 12:00 a.m. yesterday, before 12:00 a.m. today:
    • Yesterday <HH:MM[:SS] a.m. | p.m.>
    • Yesterday 10:10:05 p.m.
    • Yesterday 11:11 a.m.
  • This year, since 12:00 a.m. this year, before yesterday:
    • <3 char month name> <day>
      <HH:MM[:SS] a.m. / p.m.>
    • Jan 28 10:10:05 a.m.
  • Last year's messages, before 12:00 a.m. this year:
    • <month><day><year>
      <HH:MM[:SS] a.m. / p.m.>
    • 1/1/2011 10:10:05 a.m.

Numbers

Generally spell out numbers below 10 and use figures for 10 and higher. Spell out an approximate number if it can be expressed in a few words.

  • Every day, nine farmers pick 500 pounds of tomatoes.

Spell out numbers, except years, that begin sentences. Try to avoid starting sentences with numbers.

  • Thirty-two people became ill after eating at the establishment.

Write out stand-alone fractions.

  • One-fourth of the streetlights failed.

Avoid sucessive numerals in a single expression.

  • The project required 25 nine-volt batteries.

Oxford Comma

The Oxford comma is an optional comma before the word ‘and’, or another conjunction, at the end of a list. Xcel Energy uses the Oxford comma. Insert a comma before the conjunction that stands prior to the final item in the series.

  • The store sells tortillas, beans, and rice.

Endnotes

1. “Achieving and Balancing Consistency in User Interface Design” by Michael Zuschlag, July 19, 2010. Retrieved July 25, 2016.

2. “Xcel Energy 2016 Corporate Identity / Brand Standards Manual”. Retrieved July 25, 2016.

Energy Saving Tip

Have your home checked for leaky ducts, drafts around doors and windows, fireplace dampers, and other places where air might escape.

Break Ground, Not the Law

Always call 811 before digging in your yard to avoid hitting buried gas or electric lines. Not only is it the safe thing to do, but it's the law.