Punctuation
Bulleted lists
Capitalize the first word of every bullet. Don't use semicolons after points in a bulleted list. Include a period at the end of the bullet only if that point is a complete sentence. For example:
When you go to the store, please buy:
- Apples
- Bananas
- Naan chips
When you leave the house:
- Please buy apples, bananas, and naan chips.
- Fill the car with gas.
Colons
Capitalize the first word after a colon, only if what follows is a complete sentence. For example:
I have several favorite foods: apples, bananas, and naan chips.
I have several favorite foods: Apples were my first favorite snack, but naan chips are a rising star in my life.
Commas
We use the serial comma (sometimes called the Oxford comma). In a list of three or more, include a comma before the conjunction. For example: Please buy apples, bananas, and naan chips.
Dashes
When offsetting a phrase with dashes you should use the longer em dash (—), which is Option + Shift + -
on Macs, with a space on either side of the dash. For example:
We emphasize open, digital record keeping, and — whenever possible — we illuminate our processes.
Although we advocate using words rather than symbols, in some contexts you may use an en dash to convey a range of numbers. For example, both 10–20 students and 10 to 20 students are acceptable options. En dash is Option + -
on Macs.
We assign 2–3 people to each development team.
Quotes
These quotations are correctly punctuated:
“Would you like a banana?” he asked.
“I hate bananas,” she said. “You know I hate bananas.”
He paused before saying “bananas are not something people should hate.”
Spaces
Sentences should always be separated by a single space. Never two spaces.
Ampersands or plus signs
Use and instead of an ampersand or plus sign, unless they’re part of an official title or company name. For example, D.C. Tech Lady Hackathon + Training Day
Slashes
Avoid using the slash /
symbol. Replace it with words or commas as appropriate.