Skip to main content

Content Guide

A guide on how to write clear, consistent, and
accessible content at Skylight.

Style elements

Adhering to certain rules of grammar and mechanics helps us keep our writing clear and consistent. By promoting consistency, you avoid making users reinterpret your words over and over. This section will lay out our house style, which applies to all of our content unless otherwise noted in this guide.

Basics

Here are some guiding principles:

  • Write for all readers. Some people will read every word you write. Others will just skim. Help everyone read better by grouping related ideas together and using descriptive headers and subheaders.

  • Focus your message. Create a hierarchy of information. Lead with the main point or the most important content, in sentences, paragraphs, sections, and pages.

  • Be concise. Use short words and sentences. Avoid unnecessary modifiers.

  • Be specific. Avoid vague language. Cut the fluff.

  • Be consistent. Stick to the copy patterns and style points outlined in this guide.

Abbreviations and acronyms

If an acronym is necessary for future reference, spell the full word and follow with the acronym in parentheses on the first reference.

Yes

  • First use: The General Services Administration (GSA)
  • Second use: GSA

If the abbreviation or acronym is well known, like NASA, NAACP, or FBI, use it instead (and don’t worry about spelling it out).

At the writer’s discretion, refer to organizations on second reference with a shortened name instead of an acronym. For example, use Labor in place of Department of Labor, rather than DOL.

Don’t use periods between letters in an acronym (NOC instead of N.O.C.).

Don’t use the abbreviation “etc.” (etcetera) redundantly. If you are starting a list with “for example” (or any of its variations, including “such as,” “e.g.,” and “ex.”), you don’t need to add “etc.” to the end of the sentence.

Yes

There are many types of donuts (glazed, powder, chocolate, etc.).

No

There are many types of donuts (e.g., glazed, powder, chocolate, etc.).

Active voice

Use active voice. Avoid passive voice.

In active voice, the subject of the sentence does the action. In passive voice, the subject of the sentence has the action done to it.

Yes

Marti logged into the account.

No

The account was logged into by Marti.

Words like “was” and “by” may indicate that you’re writing in a passive voice. Scan for these words and rework sentences where they appear.

One exception is when you want to specifically emphasize the action over the subject. In some cases, this is fine.

Yes

Your account was flagged by our Abuse team.

Capitalization

We use a few different forms of capitalization depending on the context. This includes title case and sentence case.

Title case

Title case capitalizes the first letter of every word except articles, prepositions, and conjunctions. We use title case only in certain circumstances, such as the main title of a document or a file name.

Yes

Skylight Content Guide

No

Skylight content guide

Sentence case

In general, we use sentence case. Sentence case capitalizes the first letter of the first word. This includes headings and subheadings.

Yes

About this guide

No

About this Guide

Other capitalization guidelines:

  • Do capitalize proper nouns, including names of individuals, places, and agencies. The main feature of a proper noun is that it names a specific one-of-a-kind item. Use your discretion and context to determine whether to capitalize a word as a proper noun.
  • Don’t capitalize “agile,” unless it’s the first word of a sentence.
  • Don’t capitalize “open source,” unless it’s the first word of a sentence.
  • Don’t capitalize “federal” or “government.”

For more, see the word list.

When writing out an email address or website URL, use all lowercase.

Contractions

They’re great! At Skylight, we want to create a strong connection with our clients and partners. We want to get them the information they need in a straightforward way and show that we know what’s important to them. For this reason, we use contractions (“you’re” instead of “you are”).

We also encourage clients to consider using contractions, too, though we recognize this may not be the right choice for all contexts. There are times when we might need to modify our voice to sound more formal, but we also recognize that formal doesn’t need to translate to stuffy, archaic, or aloof.

Numbers

Spell out a number when it begins a sentence. In body copy, spell out numbers one through nine, and use numerals for numbers 10 and greater.

Yes

  • Nine new employees started on Monday, and 12 start next week.
  • I ate three donuts at Coffee Hour.
  • Meg won first place in last year’s Walktober contest.
  • We hosted a group of 10th graders who are learning to code.

In titles, subheadings, tables, and interface labels, use numerals instead of spelling out numbers. We do this to promote ease of reading and scannability — in titles and headings, it’s easier for readers to scan numerals than it is for them to scan written-out numbers.

Yes

  • 10 digital tech leaders you should know now
  • 6 ways to incorporate plain-language strategies

Numbers over three digits get commas.

Yes

  • 999
  • 1,000
  • 150,000

If you’re wrangling a lot of numbers, tables can help you visualize that content. Long paragraphs cluttered with numbers or dates are more difficult to scan than, for example:

Report type Dates covered Due
Quarterly (Form 3, 3Z, 3L) January 1–March 31 April 15
  April 1–June 30 July 15
  July 1–September 30 October 15
  October 1–December 31 January 31

Dates

Generally, spell out the day of the week and the month. Abbreviate only if space is an issue.

Yes

  • Saturday, January 24
  • Sat., Jan. 24

Decimals and fractions

Spell out fractions.

Yes

two-thirds

No

2/3

Use decimal points when a number can’t be easily written out as a fraction.

Yes

  • 375
  • 47.2

Money

When writing about U.S. currency, use the dollar sign before the amount. When referring to amounts of U.S. currency in cents or greater than $1 million, use numerals followed by words.

Yes

  • $20
  • $19.99
  • $2.7 million
  • 5 cents

When writing about other currencies, follow the same symbol-amount format.

Yes

  • ¥1
  • €1

Page numbering

Generally, start numbering on the first page. On rare occasions, such as in a formal client report, you may choose to start numbering after the title page.

Percentages

Use the % symbol instead of spelling out “percent.”

Ranges and spans

Use an en dash (–) to indicate a range or span of numbers.

Yes

  • It takes 20–30 days.

To add an en dash, input option-[hyphen] on Mac or alt-[hyphen] on PC. You can also insert it as a special character.

Telephone numbers

Use dashes without spaces between numbers. Use a country code if your reader is in another country.

Yes

  • 555-867-5309
  • +1-404-123-4567

Temperature

Use the degree symbol and the capital F abbreviation for Fahrenheit.

Yes

  • 98°F

Time

Use numerals and am or pm, with a space in between. Don’t use minutes for on-the-hour time.

Yes

  • 7 am
  • 7:30 pm

Use an en dash between times to indicate a time period.

Yes

  • 7 am–10:30 pm

Specify time zones when writing about an event or something else people would need to schedule. There’s no need to specify whether it’s Daylight or Standard time. For time zones within the continental United States, use abbreviations.

Yes

  • Eastern time: ET
  • Central time: CT
  • Mountain time: MT
  • Pacific time: PT

When referring to international time zones, spell them out: Nepal Standard Time, Australian Eastern Time. If a time zone doesn’t have a set name, use its Coordinated Universal Time (UTC) offset.

Abbreviate decades when referring to those within the past 100 years.

Yes

  • the ‘00s
  • the ‘90s

When referring to decades more than 100 years ago, be more specific.

Yes

  • the 1900s
  • the 1890s

Punctuation

Ampersands

Use ampersands only if it’s convention or if it’s part of a company or brand name.

Yes

  • Company: Ben & Jerry’s, AT&T
  • Convention: DE&I, R&D

In all other cases, use “and” instead of an ampersand.

Apostrophes

The apostrophe’s most common use is making a word possessive. If the word ends in an s or is plural, just add an apostrophe.

Yes

  • The donut thief ate Sam’s donut.
  • The donut thief ate Chris’ donuts.

Apostrophes can also be used to denote that you’ve dropped some letters from a word, usually for humor or emphasis. This is fine, but do it sparingly.

Colons

Use a colon (rather than an ellipsis, em dash, or comma) to offset a list.

Yes

Erin ordered three kinds of donuts: glazed, chocolate, and pumpkin.

You can also use a colon to join two related phrases. If a complete sentence follows the colon, capitalize the first word.

Yes

Erin was faced with a dilemma: She wanted a donut, but she’d just eaten a bagel.

Commas

When writing a list, use the serial comma (also known as the Oxford comma).

Yes

David admires his parents, Oprah, and Justin Timberlake.

No

David admires his parents, Oprah and Justin Timberlake.

Otherwise, use common sense. If you’re unsure, read the sentence out loud. Where you find yourself taking a breath, use a comma.

Compound adjectives

Use a hyphen (-) to denote a compound adjective that comes before the noun it’s describing.

Yes

Heavy-metal detector

No

Heavy metal detector

Hyphens join the relevant words into a single idea (for example, a “heavy-metal detector” detects heavy metals). By contrast, a “heavy metal detector” refers to a metal detector that is heavy.

Usually, a hyphen isn’t necessary for compound adjectives that follow a noun (“high-quality work” vs. “the work is high quality”).

Dashes and hyphens

Use a hyphen (-) without spaces on either side to link words into a single phrase, or to indicate a span or range.

Yes

  • first-time user
  • Monday-Friday

Use an em dash (—) with a space on either side of the dash.

Use a true em dash, not hyphens (- or –).

Yes

  • We emphasize open, digital record keeping, and — whenever possible — we illuminate our processes.
  • Austin thought Brad was the donut thief, but he was wrong — it was Lain.

To add an em dash, input shift-option-[hyphen] on Mac or alt-fn-mjij on PC. You can also insert it as a special character on Google Docs.

Ellipses

Ellipses (…) can be used to indicate that you’re trailing off before the end of a thought. Use them sparingly. Don’t use them for emphasis or drama, and don’t use them in titles or headers.

Yes

“Where did all those donuts go?” Christy asked. Lain said, “I don’t know…”

Ellipses, in brackets, can also be used to show that you’re omitting words in a quote.

Yes

“When in the Course of human events it becomes necessary for one people to dissolve the political bands which have connected them with another and to assume among the powers of the earth, […] a decent respect to the opinions of mankind requires that they should declare the causes which impel them to the separation.”

Exclamation points

Use exclamation points sparingly, and never more than one at a time. They’re like high-fives: A well-timed one is great, but too many can be annoying.

Exclamation points go inside quotation marks. Like periods and question marks, they go outside parentheses when the parenthetical is part of a larger sentence, and inside parentheses when the parenthetical stands alone.

Never use exclamation points in failure messages or alerts. When in doubt, avoid!

Periods

Periods go inside quotation marks. They go outside parentheses when the parenthetical is part of a larger sentence, and inside parentheses when the parenthetical stands alone.

Yes

  • Christy said, “I ate a donut.”
  • I ate a donut (and I ate a bagel, too).
  • I ate a donut and a bagel. (The donut was Sam’s.)

Leave a single space between sentences.

Question marks

Question marks go inside quotation marks if they’re part of the quote. Like periods, they go outside parentheses when the parenthetical is part of a larger sentence, and inside parentheses when the parenthetical stands alone.

Yes

  • Sam asked, “Did you eat my donut?”
  • Did Sam say “you can eat my donut”?

Quotation marks

Use quotes to refer to words and letters, titles of short works (like articles and poems), and direct quotations.

Periods and commas go within quotation marks. Question marks within quotes follow logic — if the question mark is part of the quotation, it goes within. If you’re asking a question that ends with a quote, it goes outside the quote.

Use single quotation marks for quotes within quotes.

Yes

  • Who was it that said, “A fool and his donut are easily parted”?
  • Brad said, “A wise man once told me, ‘A fool and his donut are easily parted.’”

Semicolons

Go easy on semicolons. They usually support long, complicated sentences that could easily be simplified. Try an em dash (—) instead, or simply start a new sentence.

Slashes

While slashes are a handy tool for taking notes and writing rough outlines, in most cases slashes can — and should — be removed from a final draft. Replace a construction like “any man/woman” with “any man or woman” in finished work.

If required in the body of the text, avoid spaces before or after slashes.

Yes

and/or

No

and/ or

In titles, subheadings, tables, and interface labels, add a space before and after the slash. We do this to promote ease of reading and scannability.

Yes

JavaScript / React

No

JavaScript/React

People, places, and things

File extensions

When referring generally to a file extension type, use all uppercase without a period. Add a lowercase s to make plural.

Yes

  • GIF
  • PDF
  • HTML
  • JPGs

When referring to a specific file, the filename should be lowercase.

Yes

  • slowclap.gif
  • mcbenefits.pdf
  • ben-twitter-profile.jpg
  • ilovedonuts.html

Names and titles

The first time you mention a person in writing, refer to them by their first and last names. On all other mentions, refer to them by their first name.

Capitalize the names of departments and teams (but not the word “team” or “department”).

Yes

  • Marketing team
  • Support department

Capitalize individual job titles when referencing a specific role used directly before an individual’s name. Don’t capitalize when referring to the role in general terms.

Yes

  • Please welcome Marketing Manager Susan James, who starts today.
  • Susan James, our marketing manager, starts today.
  • All the marketing managers ate donuts.

Don’t refer to someone as a “ninja,” “rockstar,” or “wizard” unless they literally are one.

Pronouns

If your subject’s gender is unknown or irrelevant, use “they,” “them,” and “their” as a singular pronoun. Use “he/him/his” and “she/her/her” pronouns as appropriate. Don’t use “one” as a pronoun.

For more on writing about gender, see writing inclusively.

Quotes

When quoting someone in a blog post or other publication, use the present tense.

Yes

“Working with Skylight has been a great experience,” says Jamie Smith.

Schools

The first time you mention a school, college, or university in a piece of writing, refer to it by its full official name. On all other mentions, use its more common abbreviation.

Yes

  • Georgia Institute of Technology, Georgia Tech
  • Georgia State University, GSU

Slang and jargon

Write in plain English. If you need to use a technical term, briefly define it so everyone can understand.

Avoid using formal or long words when easy or short ones will do.

Yes

  • buy
  • help
  • about

No

  • purchase
  • assist
  • approximately

States, cities, and countries

Spell out all city and state names. Don’t abbreviate city names.

Per AP Style, all cities should be accompanied by their state, with the exception of: Atlanta, Baltimore, Boston, Chicago, Cincinnati, Cleveland, Dallas, Denver, Detroit, Honolulu, Houston, Indianapolis, Las Vegas, Los Angeles, Miami, Milwaukee, Minneapolis, New Orleans, New York, Oklahoma City, Philadelphia, Phoenix, Pittsburgh, St. Louis, Salt Lake City, San Antonio, San Diego, San Francisco, Seattle, Washington.

On first mention, write out United States. On subsequent mentions, write U.S. (not US or USA).

Text formatting

Use italics to indicate the title of a long work (like a book, movie, or album) or to emphasize a word.

Yes

  • Jurassic Park
  • Brandon really loves Jurassic Park.

Left-align text, never center or right-align.

Leave one space between sentences, never two.

URLs and websites

Capitalize the names of websites and web publications. Don’t italicize.

Avoid spelling out URLs, but when you need to, leave off the http://www.

Write positively

Use positive language rather than negative language whenever possible. One way to detect negative language is to look for words like “can’t,” “don’t,” etc.

Yes

To get a donut, stand in line.

No

You can’t get a donut if you don’t stand in line.

Writing about Skylight

Our company’s legal entity name is “Skylight Inc.” Our trade name is “Skylight.” Use “Skylight Inc.” only when writing legal documents or contracts. Otherwise, use “Skylight.”

Always capitalize the first “S” and lowercase the “l” in Skylight.

Refer to Skylight as “we,” not “it.”

Writing about other companies

Honor companies’ own names for themselves and their products. Go by what’s used on their official website.

Yes

  • iPad
  • YouTube
  • Yahoo!

No

  • Ipad
  • Youtube
  • Yahoo

Refer to a company or product as “it” (not “they”).

Get expert answers.

Have a question about something? Our experts love to share what they know.
Drop us an email and we’ll get you connected.