If you are writing for SF.gov, use the following grammar and usage, based on AP Style. If something is not listed below, use AP Style.
Use Ctrl + F to search within this page
Acronyms
Acronyms help people who know your content, but are difficult for first-time users to understand. Also, because your pages will be on SF.gov with many other departments, acronyms may have different meanings in different contexts. For example, "ADU" means "Accessory Dwelling Unit" to the Planning Department, but to the Department of Public Health, ADU means "addictive diseases unit".
Write out acronyms the first time you use them on a page, including the acronym in parentheses. Do not use periods in any acronyms.
You can then use the acronym further down the page.
The Mayor’s Office of Housing and Community Development (MOHCD)...
...MOHCD will...
If you need to use the acronym to keep your title short, you must spell it out in the description.
Contact the City about your ADU
City planners can answer early questions about accessory dwelling unit (ADU) options and requirements.
Where the acronym is better known than the full term, do not write out the term. For example:
IRS
USA
ATM
PIN
URL
USPS
PDF
&, and
Use 'and' rather than & unless the '&' is part of the name, like Treasurer & Tax Collector.
Why: In some instances '&' can be corrupted to display as '&'. Also, you are calling attention to the least important word in the sentence.
Bullets
Bulleted lists make content easier to read, but only if the bullets are short. Bullets should always follow a lead sentence. The lead sentence ends with a colon. Bullets should start with a capital letter and have no punctuation within the bullet points.
Do
You must submit:
A copy of your driver's license
Your social security number
A photo
I like to eat:
Apples
Bananas
Pears
Don’t Do
Things you will need to do for your application:
You must show a photo id like your driver’s license. You will also need proof of your social security number.
Go to counter 30 and ask for Susan. She only works on Tuesdays and Thursdays. You should call to make sure she is in
On Tuesdays talk to Susan
On Wednesdays talk to John
On Fridays talk to Mary
Always capitalize 'City' when it’s short for the City and County of San Francisco or when used in place of San Francisco.
Search for jobs with the City
We want to significantly reduce the City workforce's carbon footprint.
If you are talking about cities in general, don’t capitalize.
Many cities have passed sanctuary ordinances.
Climate change is a big concern for cities across the United States.
Comma, serial or Oxford
If you have a long sentence, try to replace commas with periods.
In a series, use a comma after all items (Oxford comma).
I like to eat apples, bananas, and pears.
I like to eat fruit salad, eggs and bacon, and hash browns.
Contractions
Shortening 2 words into 1 can make your writing more informal and friendly. However, negative contractions, like 'don’t' and 'shouldn’t' are sometimes misread, particularly in instructions. So on SF.gov, do not use contractions in service or instructional content.
For a news story or lighter content, it’s fine to use contractions.
Dashes and hyphens
We do not use dashes on SF.gov.
If you have used a dash, try to rewrite the phrase or sentence.
We use hyphens in common nouns, phone numbers, and zip codes.
Use a hyphen (-) without spaces on either side to link words into a single phrase. When the phrase can be spelled as one word, remove the hyphen.
Do not use a hyphen to indicate a span or range, instead spell out the range.
Do
building with 203 units
203-unit building
meeting
in-person meeting
Monday to Friday
Monday-Friday
isolate yourself at home
self-isolate at home
Don’t Do
cosponsor
co-sponsor
in-law unit
car-free
10-minute delay
800-708-6733
94102-9911
Dates
We write dates as month, day, year. We write out the month and use numbers for day and year. We write years as 4 numbers, like 1900 and 2020.
Other countries use different formats for dates, so it’s clearer to write out the month. And some people find it difficult to read '/'.
When writing dates use cardinal numbers, not ordinal. When speaking about dates the convention is to use ordinal numbers, but in writing, the convention is to use cardinal.
When space is limited use only the first 3 letters of the month. Otherwise, write out the month.
Do
January 28, 2020
1/28/2020
Don’t Do
Jan 28, 2020
1/28/20
Jan 28
January 28th
When space is limited it’s acceptable to use only the first 3 letters of the month. Otherwise, write out the month.
See Years for calendar years, tax years and school years.
Ellipses
Do not use ellipses. They cause confusion.
Gender
Do not ask for gender unless you really need it. Making people fit themselves into categories can stress people.
Also, there is a risk to storing and managing that data securely. Make sure you have a plan to store and anonymize the data, and that the value of the data is worth the risk.
If you do really need it, explain why you need it and how you will use the data. Tell people how you will store the data safely.
We talk about 'transgender and gender nonconforming people'. If you are writing for experts, you can use 'gender nonconforming (GNC)' when you use the term first. Then you can use GNC after that.
- Male
- Female
- Trans male
- Trans female
- Genderqueer / Gender Non-binary
- Other _______
- Decline to answer
This format allows people to choose if they want to disclose if they are transgender or not, as they could also just select the Male or Female options.
For new staff, only ask demographic questions after hiring, such as during an onboarding survey, so there is no potential discrimination in the hiring process.
In order to
Do not use “in order to” when you mean “to”. It may seem more precise or formal but it does not add to understanding.
Do
The Domestic Partnership must be filed with the County Clerk to have a commitment ceremony performed by our office
Don’t Do
The Domestic Partnership must be filed with the County Clerk in order to have a commitment ceremony performed by our office.
It is, it’s and its’
It's = it is (or it has)
Its = belonging to it
Its’ = no meaning. Don’t use.
It’s a short drive to Mountain View.
The monster is green. Its teeth are yellow.
Latin
Do not use i.e., e.g., or etc.
Because they are Latin terms, they are not easily understood by everyone. Because of the periods, these terms take visual prominence in your sentence. They shouldn’t.
Screen readers also pronounce these terms unpredictably.
Do
Like
i.e.
Like, for example (for leave it out)
Don’t Do
e.g.
Don’t use; be specific or don’t include the term
etc.
Links
Link to webpages, not pdfs. We do this so links don’t get broken if the webpage owner updates the PDF.
Also, let the webpage owner know if you have used information from their page, like fees, that will need to be updated.