DoIT Communications editorial style guide
To make editorial style choices, we consult:
- UW–Madison Editorial Style Guide, published and updated by the Office of Strategic Communication
- AP Stylebook, published and updated by The Associated Press (AP)
- Merriam-Webster, AP’s partner dictionary
Abbreviations
Acronyms
Technology is full of acronyms. Spell out the full name on first reference, followed by the acronym in parentheses. Use the acronym after that.
Example: Digital Publishing & Printing Services (DPPS) provides full-service digital media and a wide range of printing services for UW–Madison. DPPS can print any item you need, from brochures to business cards.
In headlines and excerpts for DoITnet, it.wisc.edu, the Connection and TechNews, you can skip the parentheses to save space. Make sure the acronym is spelled out in either the headline or the excerpt, and use the parentheses in the article itself.
Examples:
- Headline: Equity, Diversity & Inclusion Committee leadership opportunity
- Excerpt: An EDIC co-chair role is opening up. We’re extending this leadership opportunity to the entire DoIT community.
Or
- Headline: EDIC leadership opportunity
- Excerpt: An Equity, Diversity & Inclusion Committee co-chair role is opening up. We’re extending this leadership opportunity to the entire DoIT community.
Spell out DoIT on first reference in external communications (TechNews and it.wisc.edu). You don’t need to in internal ones (the Connection and DoITnet).
Example:
- Headline: DoIT Help Desk resumes normal hours
- Excerpt: The Division of Information Technology Help Desk will switch to fall semester hours starting Aug. 24. On Labor Day, you can reach the Help Desk by phone, chat or email.
Periods in abbreviations
Follow AP style for abbreviations and acronyms. Use periods in shortened words and Latin abbreviations: Jan., Sept., Ave., St., a.m., p.m., e.g., i.e., Dr. Don’t use periods in acronyms and initialisms: DoIT, MFA, KB, UW.
Addresses
Follow AP style for addresses. Use the abbreviations Ave., Blvd. and St. with a numbered address. Spell them out and capitalize when part of a formal street name without a number. Always spell out similar words (Alley, Drive, Road, Terrace, etc.). Abbreviate compass points in an address: 1210 W. Dayton St.
Examples:
- Memorial Library, 728 State St.
- 21 N. Breese Terrace
- 1210 W. Dayton St.
- Use the entrance on Dayton Street.
Exception: Don’t abbreviate compass points in addresses on East Campus Mall. “University Health Services is at 333 East Campus Mall.”
Alt text & image descriptions
Alternative (alt) text and image descriptions are short descriptions of an image. Alt text explains the “what” of an image and the “why” — the meaning the image gives to our visual audience.
It’s best to keep picture descriptions short — 150 characters or fewer. Don’t use extra words like “image” or give too many small details about the picture.
Learn more about alt text and image descriptions.
Ampersands
Use an ampersand when it’s part of a proper noun, including department, school, college, division, committee, program, project and IT service names.
Examples:
- Systems Engineering & Operations
- College of Computing & Artificial Intelligence
- Equity, Diversity & Inclusion Committee
- Search & Screen Committee
Use an ampersand in job titles: Vice Provost for Information Technology & Chief Information Officer.
Use an ampersand in web menu items.
Use an ampersand in headlines and headers in place of “and” to conserve characters.
Examples:
- Learn & grow with EDUCAUSE
- Stay informed about IT outages & planned maintenance
Spell out “and” in the body of your text, including paragraphs and lists. In excerpts, use an ampersand in place of “and” only when referencing dates.
Examples:
- The workshops will be held Jan. 17 & 18.
- Join us for an engaging and rewarding workshop.
Note: This differs from UW style for ampersands, which treats the ampersand as acceptable only in official names.
Capitalization & proper nouns
In general, err on the side of capitalizing only proper nouns. When referencing IT projects, initiatives and programs, capitalize the name of the project, initiative or program, including the word “Project,” “Initiative” or “Program.”
Examples:
- Data Classification Initiative
- Digital Accessibility Policy Implementation Project
- IT Federation Program
Do the same for teams and committees, capitalizing the word “Team” or “Committee.”
Examples:
- Communications Team
- M-Team
- Equity, Diversity & Inclusion Committee
Consider whether the reference needs the word “Team,” “Project” or “Initiative” to be understood. “Ask DoIT Communications for help” is just as clear as — and shorter than — “Ask the DoIT Communications Team for help.”
Don’t capitalize nonspecific references to the university, a department, a college or a school. “UW–Madison has an important relationship with the state. The university is a key driver of Wisconsin’s economic growth.”
For the terms DoIT Communications treats as proper nouns — along with acronyms, short forms, descriptions and links — refer to the companion document, the DoIT Communications glossary & proper nouns.
For titles of projects, policies, webinars, KB articles and the like, refer to Composition titles.
Commas
Serial comma
Follow the AP Stylebook rule on commas: no serial (Oxford) comma in simple lists. Also following AP, add a serial comma when clarity requires it, such as in lists with compound items.
No serial comma:
- Red, white, purple and blue
- The chancellor, provost and vice provost spoke on the issue.
- The initiative affected several schools, colleges, institutes and other units.
Serial comma for clarity:
- I had toast, juice, and ham and eggs for breakfast.
- We needed a research collaboration strategy, a talent recruitment strategy, and a professional development and training strategy.
Note: This differs from UW style on commas, but follows the style for news communications produced by the Office of Strategic Communication.
Compose, comprise & constitute
Follow AP style for compose, comprise and constitute. These three are close in meaning but not interchangeable.
- Compose means to create or put together. It works in both active and passive voice. “She composed a song. The United States is composed of 50 states.”
- Comprise means to contain, include all or embrace. Use it in the active voice, followed by a direct object. “The United States comprises 50 states.”
- Constitute means to form or make up. Reach for it when neither of the others fits. “Fifty states constitute the United States.”
- Include is the right word when what follows is only part of the total. “The price includes breakfast.”
“Comprised of” is nonstandard, though it has become common. Avoid “the United States is comprised of 50 states” and similar constructions.
Composition titles
Follow the AP Stylebook rule on composition titles:
- Capitalize all words in a title except articles (a, an, the), prepositions of three or fewer letters (for, of, on, up) and conjunctions of three or fewer letters (and, but, for, nor, or, so, yet) — unless one of those starts or ends the title.
- Capitalize prepositions and conjunctions of four or more letters: “above, after, down, inside, over, with, because, while, since, though.”
- Capitalize both parts of a phrasal verb: “What to Look For in a Mate.”
- Capitalize “to” in infinitives: “What I Want To Be When I Grow Up.”
- Put quotation marks around the names of books, movies, plays, songs, and radio and television programs. Don’t use them for reference works, software, apps or games.
In our academic environment, apply the same capitalization to major projects, initiatives, lectures, programs, policy titles, webinars, workshops, seminars, conference sessions, lunch-&-learns and KnowledgeBase articles.
Quotation marks: Use double quotation marks in paragraph text and excerpts. Use single quotation marks in headlines and subheads. There’s generally no need to put quotation marks around KB article titles, webinar titles and similar — and in long lists, quotation marks around every item get cumbersome. Use your judgment.
Exception: When you create a KnowledgeBase document, put its own Title field in sentence case, following our headline rule — “DoIT Communications editorial style guide,” not “DoIT Communications Editorial Style Guide.” Composition-title capitalization applies when you “cite” an article’s title inside your copy, not when you name the document you’re creating.
Examples:
- Paragraph text: Register for “Change Management 101,” the next session in our lunch-&-learn series.
- Headline: Register for ‘Change Management 101’
Dashes
Use an em dash (—) to set off a phrase that adds information or interrupts the sentence. Put a space on both sides.
Examples:
- The rain in Spain falls mainly on the plain — a large, flat area without trees.
- Learning a new technology can be difficult — as anyone who’s done so will tell you — but the rewards are great.
Don’t build an em dash from a pair of hyphens.
Don’t use a dash of any kind to show a range of times, dates or numbers. Use the word “to” instead (refer to Numbers and Times).
Use an en dash (–) in “UW–Madison” and “University of Wisconsin–Madison” — with a word joiner after the dash (refer to UW–Madison).
Caution: In email subject lines, type “UW–Madison” fresh instead of copying it from a web page to avoid copying hidden characters.
Dates
Follow UW style for dates, AP style for dates and AP style for months.
In headlines, excerpts, subheads and the body of articles and web pages:
- When writing dates, abbreviate only Jan., Feb., Aug., Sept., Oct., Nov. and Dec. Always spell out March, April, May, June and July.
- Spell out the month when it stands alone or appears with only a year.
- Spell out days of the week: Monday, Tuesday, Wednesday, etc.
- Don’t use ordinals in dates. “May 11,” not “May 11th.”
For a range of dates, use the word “to” rather than a dash: “Oct. 9 to 12.” This helps people using screen readers, which may not announce a dash as a range.
Degrees
Follow UW style for degrees: spell them out instead of abbreviating them. Use bachelor’s degree, bachelor of arts degree, bachelor of science in physics, master’s degree, doctorate and the like.
e.g. & i.e.
Follow AP style for e.g. and i.e.
- e.g. means “for example” (Latin: exempli gratia) and is used to provide a list of examples.
- i.e. means “that is” or “in other words” (Latin: id est) and is used to clarify or rephrase a preceding statement.
- Think: e.g. = “example given” and i.e. = “in essence.”
- Always follow both with a comma.
Consider writing “for example” or “that is” instead in public-facing communication. The spelled-out phrases are clearer to more readers.
Examples:
- Bucky’s our Badger (i.e., UW–Madison’s mascot).
- Babcock Dairy Store makes the best ice cream flavors (e.g., Badger Blast, Union Utopia, Bits & Bytes).
Headings
Accessibility best practice: Headings give your content a structure that readers and assistive technology can follow. Some key principles:
- Use only one H1 heading for the title of a document or web page. Always include an H1 when using headings.
- Nest later headings in order by level: H2, H3, H4, etc.
- Never skip heading levels (like skipping from an H2 to an H4). It can confuse people who use screen readers or other assistive technology.
Use sentence case in all headings and subheads. Don’t create a heading by bolding default paragraph text — use the heading tools your platform provides so the structure is available to assistive technology.
Learn more about using headings and titles.
Headlines & titles
Don’t end headlines with punctuation. Use an ampersand in headlines and headers (in place of “and”) to conserve characters. Use sentence case.
Example: Going OOO? Delegate your time & absence approvals
Use single quotation marks in headlines when referencing a composition title:
Example: ‘Stress or Success? Thriving in a Chaotic World’
Job titles
Capitalize job titles in all instances, whether the title comes before or after the person’s name.
Examples:
- Chief Information Officer Didier Contis joined UW–Madison in July 2025.
- Didier Contis, Chief Information Officer, joined UW–Madison in July 2025.
- The university’s Chief Information Officer joined UW–Madison in July 2025.
Note: This differs from AP style for titles and UW style for titles of people, which lowercase a title that follows a name. We break from that rule because academia often doesn’t follow it.
In general, don’t use “Mrs.,” “Mr.” or “Ms.” Use “Dr.” only for medical doctors — except when there’s a strong personal preference, in which case make sure to apply it consistently for all names in the document or article.
Links
Write link text that makes sense on its own. People who use screen readers often pull up a list of a page’s links, so they hear the link text without the surrounding sentence.
Examples:
- Yes: Get detailed instructions on how to view and print your W-2 form.
- No: Get detailed instructions on how to view and print your W-2 form here.
Learn more about making links and buttons accessible.
Links in print
In printed materials and digital signage, keep URLs short and easy to read. Use the go.wisc.edu URL shortening service for print URLs.
A QR code can help people get from a poster, flyer or slide to a web page, but not everyone can scan one. When you use a QR code:
- Print the short URL next to it, so the code is never the only way to reach the link.
- Say what people get when they scan, like “Scan to register.” Don’t leave a code unlabeled.
- Point it to a page that works well on a phone. Avoid linking to PDF documents and large files.
- Make it large enough to scan from where people will stand, dark on a light background, with clear space around the edges.
- Test the printed proof with more than one phone before the print run.
Examples:
- Yes: Find out more about this great seminar: go.wisc.edu/whatever
- Yes: Scan to register or visit go.wisc.edu/whatever
- No: A QR code with no label or URL
Lists
Capitalize the first word of each list item. End list items with periods only if the items are complete sentences. Format all items in a list the same way.
Use a bulleted list when the list doesn’t have a progressive or hierarchical order — for example, a list of departments:
Example:
- Communications
- Human Resources
- Network Services
- Systems Engineering & Operations
Use a numbered list when order matters, such as in step-by-step instructions or rankings:
Example:
- First step
- Second step
- Third step
Learn more about making lists accessible.
Sorting list items
Readers may infer rank or importance from the order of names, projects or departments, and an order that seems arbitrary can suggest bias.
For unordered lists:
- Sort alphabetically when items are of the same type.
- Sort by surname (also called “last name” or “family name”) when listing people.
If you use a different sorting order, make the reason obvious or explain it in the lead-in sentence.
Numbers
Follow AP style for numerals: In general, spell out one through nine. Use numerals for 10 and above.
Exceptions
Use numerals for phases, steps and sprints, which come up frequently in IT work.
Examples:
- Phase 1
- Step 4
- Sprints 9 and 10
Number ranges
Use the word “to” rather than a dash: “5 to 7,” not “5-7.” Some screen reader software won’t announce dashes, so “5-7” sounds like “5 7,” which loses the meaning.
Percentages
Follow AP style for percent, percentage and percentage points: Use numerals and the % sign, with no space.
Examples:
- Average hourly pay rose 3.1% from a year ago.
- 60% of the class passed.
- The cost of living rose 0.6%.
Note: This differs from UW style for percentages, which spells out “percent” in running text and permits the % symbol only in lists, tables and charts.
Phone numbers
Use hyphens rather than periods. Don’t put the area code in parentheses.
Examples:
- Yes: 608-555-1212
- No: (608) 555-1212
- No: 608.555.1212
Tip: In web content, link phone numbers with tel: so people can tap to call.
Example: <a href="tel:6085551212">608-555-1212</a>
Plain language & inclusion
Plain language is writing your audience can understand the first time they read or hear it. Your writing is in plain language if your audience can:
- Find what they need
- Understand what they find the first time they read or hear it
- Use what they find to meet their needs
Write for and about people in a way that’s inclusive, empathetic and respectful. Describe only relevant characteristics, and consider whether the information is necessary to the content at all.
Learn more about plain language writing and writing for inclusion.
Tech terms
Technical terms, product names, unit names and their approved spellings live in the DoIT Communications glossary & proper nouns.
For inclusive replacements for legacy IT terminology, use the UW Guide to Inclusive Terms.
Text formatting
Formatting should support your words, not replace them. Screen readers skip most formatting, so a sentence needs to make sense with all of it stripped away. Use formatting sparingly and consistently.
Bold
Use bold to call out a key word or short phrase, like a deadline or a required action. If everything is bold, nothing stands out, so don’t bold whole sentences or paragraphs. Don’t use bold to create a heading (refer to Headings).
Italics
Don’t use italics for emphasis. Use bold instead. Don’t italicize composition titles; put them in quotation marks (refer to Composition titles).
Exception: Italicize a word or phrase when you’re discussing the term itself rather than using it.
Example: Use allowlist instead of whitelist.
Underline
Never add an underline manually. Readers expect underlined text to be a link, so don’t use it for emphasis or hierarchy.
Underlines that applications add automatically to links are fine — preferred, even. It’s the manual ones to avoid.
All caps
Don’t use all caps for emphasis. All-caps text is harder to read and comes across as shouting. Some screen readers may also read it one letter at a time. Acronyms and names styled in all caps are fine — check the glossary & proper nouns for the approved form.
Strikethrough
Don’t use strikethrough to show a change, like a new date or room. Most screen readers don’t announce it, so the old and new information run together. Say what changed instead.
Examples:
- Yes: The workshop moved to Jan. 18.
- No: The workshop is
Jan. 17Jan. 18.
Color
- Don’t use color as the only way to convey meaning. “Required fields are in red” fails for people who can’t perceive red. Add a word, label or symbol too.
- Make sure all text has enough contrast with its background, including dark text on a tinted background: at least 4.5:1 for regular text and 3:1 for large text (18 point, or 14 point bold), per WCAG 2.1 AA.
- Don’t make text blue if it isn’t a link. Readers expect blue text to be a link.
Text size
Use heading styles, not a bigger font size, to show hierarchy. Don’t shrink text to fit more on a page or slide — cut words instead.
Alignment
Left-align body text. Centered and justified text are harder to read, especially for people with dyslexia. Center only short lines, like a title on a flyer.
Times
Follow AP style for time and time of day:
Examples:
- 9 a.m.
- 3:15 p.m.
- noon
- midnight
For accessibility reasons, don’t use a dash to indicate a range of time:
Examples:
- Yes: 9 a.m. to 10 a.m.
- No: 9 a.m. - 10 a.m.
For virtual event communications, include the time zone to support DoIT’s many employees who live and work outside the Central time zone. Per AP style for time zones, use “Central time zone” on first reference and “CT” on later references. However, it’s okay to use “CT” in lists for brevity.
UW–Madison
Use an en dash in “UW–Madison” and “University of Wisconsin–Madison,” not a hyphen.
Use the full name on first reference in formal, external-facing writing, and “UW–Madison” as the short form. Precede the name with “the” only when using the full version — never write “the UW–Madison” or “the UW.”
Use “Universities of Wisconsin” for the overarching system on first reference, and “UW system” after.
'Campus' & 'university'
The UW–Madison campus is a physical place that you can point to on a map, but employees often use the word figuratively to refer to the university as an institution or as a shorthand way to refer to departments, units and people. Because many DoIT employees work out of state and will likely never set foot on the literal campus, we strive for more precision when using "campus."
Use “campus” only for the physical location and its buildings. For the institution and its people, use “UW” or “university.”
Examples:
- Yes: university websites
- No: campus websites
- Yes: campus Wi-Fi nodes
The word joiner
In digital content, DoIT style adds a word joiner (U+2060) to the university's name immediately after the en dash, so “Madison” can’t wrap to the next line on its own.
| Context | Copy-paste ready |
|---|---|
| Plain text, Word, Google Docs, email | UW–Madison |
| HTML | UW–⁠Madison |
The joiner goes after the dash, not before. Per Unicode UAX #14, the en dash (U+2013) has line-break class BA, “break after,” so the break opportunity sits between the dash and “Madison.” A joiner placed before the dash suppresses a break that was never available there and leaves the real one untouched.
Caution: Use the word joiner (U+2060), not a zero-width joiner (U+200D). Both suppress the break, but the zero-width joiner exists to form ligatures and emoji sequences; the word joiner is the character defined for exactly this purpose and carries no other meaning. Older DoIT content uses ‍ — that’s the wrong character. Fix it when you edit the page.