City of Boston writing guide
We have tips for what to do — and what not to do — when writing content for the City of Boston.
What to do
Have an idea of who you want to provide the information to before you start. What you're writing should be like a conversation with a friend.Remember to use the active voice
For example, instead of writing, “The bill should be paid by the property owner,” we would write, “The property owner pays the bill.” It’s much more simple and direct.
An easy way to tell if you are using the active or passive voice is to add “by zombies” after the verb in the sentence. If the sentence still makes sense after adding “by zombies,” it’s in the passive voice. If not, it’s in the active voice. For example:
- Passive: The town was attacked (by zombies). Still makes sense.
- Active: Zombies attacked (by zombies) the town. Doesn’t make sense.
There are trickier versions of the passive voice, but this is an easy tip to keep in mind.
If a headline is longer than 11 words, it’s probably too long. Use full names and titles in headlines. Paragraphs should be two to three sentences at most. Aim for a sentence length of 15 to 20 words. For example:
- “Perhaps more important than fire fighting itself in many modern industrial countries is fire prevention,” could just be: “Fire prevention is important.”
Brevity can also increase readability and make the site more friendly for people using smartphones.Write for smaller screens
The more text, the more scrolling someone does on their smartphone or tablet.
Do you find yourself with a big paragraph? By breaking down your points into a bulleted list instead of a huge block of text, you’ll increase readability and comprehension. For example:
“The Fire Prevention Division, in the Boston Fire Department, directs fire prevention activities. It handles the more technical fire prevention problems, maintains appropriate records, grants permits, investigates the causes of fires, and conducts public education programs,” could just be:
“The Fire Prevention Division:
- handles more technical fire prevention problems
- maintains appropriate records
- grants permits
- investigates the cause of fires, and
- conducts public education programs.”
Just remember, you don’t have to bullet everything on a page. Only use bulleted lists when they make sense.
Don’t be afraid to say "we" instead of “The City.” Instead of "residents" or “applicants,” consider saying "you."Can we use a photo with the content?
Photos add depth to what you are talking about, and may provide greater context for users struggling with reading comprehension.Break up content into blocks or chunks
This allows readers to digest the content more easily. Ideally, you should separate these blocks of text with headlines and bullet lists of information.Write as you talk
This is a common rule in writing. The content that you create should be like a conversation between two people. Stuffy language can get in the way.
One of the easiest ways to write as you talk is with contractions. People talk in contractions — like can’t and don’t — and using them helps people relate to what you’re writing. The important thing to remember, though, is not to overuse them. Only use them when they sound natural.
What to avoid
We should be writing to the person with the least amount of knowledge on the topic. See a list of plain English words to use instead.Run-on sentences and multiple commas in a sentence
Use periods where you can to help a reader digest the content.Words like “may” and “shall”
When something needs to be done to complete a task, make sure a resident knows by using strong words like “must.”Acronyms
A human-centered website doesn’t require a government reference guide. Explain what it is you're talking about in detail.
While symbols — like “&” and “@” — can shorten your text, please just spell out what you’re writing. Symbols like these will only confuse your readers, especially those who may be learning English as a second language.Repetition
If the full title of person or place has been used already as a first reference on the page, we don’t have to repeat that full title. “Mayor Michelle Wu” would simply become “the Mayor” down the page.
Associated Press style
Use the abbreviations Ave., Blvd., and St. only with a numbered address: 1600 Pennsylvania Ave. Spell them out and capitalize when part of a formal street name without a number: Pennsylvania Avenue. Lowercase and spell out when used alone or with more than one street name: Massachusetts and Pennsylvania avenues.
All similar words (alley, drive, road, terrace, etc.) always are spelled out. Capitalize them when part of a formal name without a number; lowercase when used alone or with two or more names.
Always use figures for an address number: 9 Morningside Circle. Spell out and capitalize First through Ninth when used as street names; use figures for 10th and above: 7 Fifth Ave., 100 21st St.
Always use Arabic figures for dates, without st, nd, rd, or th. For example:
- We were married on July 1, 2013.
- On September 5, we celebrate Labor Day.
For text used as a headline, only capitalize the first word and proper nouns. Use single quotes for quotation marks. For example:
- Neighborhood Development joins federal housing program
- Mayor names new director for Animal Control
- ‘Prepare for the storm,’ Mayor says
In general, spell out one through nine: The Red Sox finished first. He had nine months to go.
Use figures for 10 and above, and whenever preceding a unit of measure or referring to ages of people, animals, events, or things. For percentages, use numerals with “percent,” not “%”. For example:
- We picked more than 20 apples at the orchard.
- The City Council is revising the 8-year-old laws.
- We want you to spend 50 percent of your time on reading.
Use figures except for noon and midnight. Use a colon to separate hours from minutes. You don’t need the “:00” when referring to an hour of the day. For example:
- The meeting took place at 11 a.m., but we plan to meet again at 3:30 p.m.
When referring to a time span, please use a hyphen instead of the words “to” or “through.” For example:
- A typical work day for most people takes place from 9 a.m. - 5 p.m.
If you are writing about a time span in the afternoon, evening, or in the morning, you don’t need to write out the first a.m. or p.m. For example:
- We plan to discuss the proposal from 9-11 a.m. We should also set some time aside from 3-5 p.m.
Capitalize formal titles when they are used before one or more names: Pope Francis, President Barack Obama, Vice Presidents John Jones and William Smith.
Lowercase and spell out titles when they are not used with an individual’s name: The president issued a statement. The pope gave his blessing.
Lowercase and spell out titles in constructions that set them off from a name by commas. For example:
- The vice president, Joe Biden, was re-elected in 2012.
- Pope Francis, the current pope, was born in Argentina.
There are certain exceptions to this rule for the City of Boston, which you can find below.
Use figures, without commas, for years: 1975. Use an s without an apostrophe to indicate spaces of decades or centuries: the 1890s, the 1800s.
- January 1972 was a cold month. January 2 was the coldest day of the month.
- His birthday is May 8. February 14, 1987, was the target date.
- She testified that it was Friday, December 3, when the accident occurred.
Special writing rules
Always capitalize “Mayor” when referring to the Mayor of Boston. This is true whether or not you use the Mayor’s name. For example:
- Mayor Michelle Wu is coming to the meeting today.
- Michelle Wu, the Mayor of Boston, is coming to the meeting today.
- The Mayor is coming to the meeting today.
If you are talking about “mayors” in general, you do not need to capitalize the word. For example:
- Mayor Michelle Wu will be among the mayors who will visit the White House this week.
- Climate change is a big concern for mayors in many major cities along the coast.
Always capitalize “City Council” when referring to the Boston City Council. This is true whether or not you use “Boston” before “City Council.” For example:
- The Boston City Council will make a decision on the ordinance today.
- The City Council will make a decision on the ordinance today.
If you are talking about “city councils” in general, you do not need to capitalize the words. For example:
- In many major cities, city councils help enact laws.
Always capitalize “City” when referring to the City of Boston. For example:
- The City is ready for First Night.
- This time of year, students from around the world come to the City to attend college.
If you are talking about “cities” in general, you do not need to capitalize the word. For example:
- Boston is one of the major cities on the East Coast.
- Climate change is a big concern for cities across the United States.
Always use the “oxford” comma. If you use a serial list in your writing, please remember to include a comma before “and” at the end of the sentence. For example:
- Boston’s professional sports teams include the Patriots, Red Sox, Bruins, and Celtics.
Always use the click-to-call friendly format for phone numbers. Remember to use dashes so that the numbers are recognized on mobile devices. For example:
- Please use 617-353-4500, instead of (617) 653-4500, or 617.635.4500.