Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This resource is intended for all Travis County staff and provides guidelines and best practices for generating written content. It covers tone, grammar, punctuation, formatting, and more.

...

This guide is based on elements from the Associated Press Stylebook and the Chicago Manual of Style.

Acronyms

Acronyms, while beneficial for audiences familiar with the subject matter, can pose challenges for first-time readers and may carry different meanings in diverse contexts. For instance, “ADU” in the City of San Francisco can refer to “Accessory Dwelling Unit” for the Planning Department or “Addictive Diseases Unit” for the Department of Public Health.

...

  • ATM

  • COVID

  • IRS

  • PDF

  • PIN

  • RSVP

  • URL

  • USA

  • USPS

Ampersand (&, and)

Use “and” rather than “&” unless the “&” is part of a proper name, like Treasurer & Tax Collector.

Bullets

Never use dashes.

Bulleted lists improve the readability and discoverability of content, but only if the bullet points are short and deliver value.

There are different formats for bulleted lists and you should consider which structure would best represent your content online.

Formal content

Bulleted lists in formal content, such as studies and advisories, should be structured in a way that matches the formality.

...

  • Your bulleted items should then end with a period.

  • Never use semicolons to end punctuation of a bulleted item.

Informal content

Informal or otherwise low-impact content, such as text on flyers, may not require the same punctuation standards. Periods at the end of a bulleted item may not be required if the item is either only one word or a short phrase that feels like an inventory or shopping list. Study the example below.

...

  • Boxed cereals

  • Canned food

  • Feminine hygiene products

  • Small toiletries

  • Socks and undergarments

Capitalization

Capitalize when words are a crucial part of a proper name. For example, Travis County, Harris County, or Tarrant County.

...

Use lowercase for the word “county” when distinguishing an agency from state or federal counterparts. For example, the Texas Health and Human Services Department versus the county’s Health and Human Services Department; the Department of Social Services versus the county Department of Social Services. Use lowercase for 'board,' 'department,' etc. wherever those terms stand alone.

Titles

In general, limit capitalization to formal titles directly preceding an individual's name. For example:

...

The determination on whether a title is formal or occupational depends on the practice of the governmental or private organization that confers it. If there is doubt about the status of a title and/or the practice of the organization cannot be determined, use sentence construction that sets the name or title apart using commas.

Abbreviated titles

The following formal titles are capitalized and abbreviated as shown when used before a name both inside and outside quotations: Dr., Gov., Lt. Gov., Rep., Sen. and certain military ranks.

All other formal titles must be spelled out in all uses.

Past and future titles

Capitalize a formal title that an individual formerly held, is about to hold, or holds temporarily before the person's name. Do not capitalize the qualifying word. For example:

  • After Tuesday’s meeting, former County Judge Sarah Eckhardt received a standing ovation.

  • District Attorney-elect Jose Garza will be sworn in next month.

Long titles

Separate a long title from a name with a construction that requires a comma. For example:

  • Omar Robinson, the deputy co-chair, spoke.

  • The deputy co-chair of the energy commission, Omar Robinson, spoke.

Unique titles

If a title applies only to one person in an organization, insert the word 'the' in a construction that uses commas:

...

Don’t capitalize titles if they follow a name or stand alone, such as the judge and the commissioner.

Commas

Travis County staff should always use the Oxford comma, also known as the serial comma, when writing. The Oxford comma is used before the conjunction ("and" or "or") in a list of three or more items.

...

The Oxford comma is placed right after the word "two."

Contractions

Shortening two words into one can provide a more informal and friendly tone to your writing. However, negative contractions, like “don’t” and “shouldn’t,” can be occasionally misread, especially in instructional contexts. For that reason, staff should avoid using contractions in service or instructional content. In these instances, keep the words separate, as shown below:

  • Clerks are not allowed to provide assistance on your case.

Dashes and hyphens

Travis County staff should avoid using "em dashes" or hyphens in text.

...

  • (512) 555-5555 instead of 512-555-5555.

Dates

When writing dates, Travis County staff should spell out the month in full and use numerals for both the day and year. Years must be written as four numbers, such as 1989 and 2013.

...

  • Feb. 11, 2024 not 02/11/2024.

Gender

For Travis County staff engaged in community outreach, avoid requesting information on gender unless it is absolutely necessary. Compelling constituents to conform to categories that may not align with their gender identity can cause unnecessary stress.

...

This format empowers constituents to choose from a wider pool of options or whether they wish to disclose their gender at all. This promotes more accurate data collection that reflects the diverse nature of Travis County residents.

It is, it's, its

In written communication, it is crucial to distinguish between the frequently confused terms "it is," "its," and "it's." Understanding the nuances among these forms is essential for maintaining clarity and precision in your writing. Study the examples below.

It is

This is a contraction combining the pronoun "it" with the verb "is." It is used to express the state, condition, or characteristic of a subject. For example:

  • It is raining outside.

Its

This a possessive pronoun indicating ownership or association. It is used when referring to something belonging to or associated with an inanimate object or animal. For example:

The dog wagged its tail.

It's

This is a contraction merging the pronoun "it" with the verb "is" or "has." It is used to represent "it is" or "it has." Examples:

  • It's a beautiful day.

  • It's been a long journey.

Its'

This has no meaning. Do not use.

Links

A hyperlink, often referred to as a link, is a clickable element that connects to another document, webpage, or resource, facilitating seamless navigation between different online locations. Links play a vital role in guiding users to either external websites or internal webpages within the Travis County website. To ensure consistency and enhance user experience, adhere to the following guidelines:

...

Bolded and underlined text, typically automatically formatted into a blue or purple font, indicates to the reader that they may have the option to activate a hyperlink action. Text that is bolded and underlined without being hyperlinked impacts the usability of content and confuses readers.

Context

Never publish a URL as a link. Plain URLs negatively impact readability and accessibility standards. All hyperlinks must be presented as words or phrases providing context for the linked content. Avoid using generic phrases like "click here." Instead, utilize descriptive and meaningful text accurately representing the link’s destination. Study the examples below.

Do

Don’t

Notes

Learn more about our services.

Click here for more info.

Hyperlinking the text “our services” lets readers know they can expect to be taken to a page specific to services. On the other hand, the text “here” can refer to any number of topics or subject matter.

Learn more about our services.

Learn more about our services.

Lengthy hyperlinked text can cause confusion and negatively impacts the discoverability of content. Short descriptive text helps improve the discoverability and readability of content.

Once the affidavit is signed by a notary, please submit it to the District Clerk’s Office.

Once the affidavit is signed by a notary, please submit it to the District Clerk’s Office. Visit their website at https://www.traviscountytx.gov/district-clerk

The hyperlinked text “District Clerk’s Office” complies with accessibility standards as the text is easily picked up by users who rely on screen readers. A URL hyperlink impacts the readability of the text as it is not easily or immediately recognizable where the URL redirects.

Note: Some hyperlinks presented in the examples above aren’t real. The blue and underlined text are only there to demonstrate proper contextual use of hyperlinks.

Numbers

Consistency and precision in presenting numbers are critical for effective communication. Travis County staff should consider the formats below when text uses numbers. Standards may change in various contexts. Please follow the guidelines below when incorporating numbers in your writing.

General numerical representation

Spell out whole numbers from one to nine. Use numerals for numbers 10 and above. For example:

  • Commissioner Ann Howard submitted three reports and cast 15 votes.

Beginning sentences with numbers

Spell out a number at the beginning of a sentence, regardless of its value. For example:

  • Forty-seven constituents attended the meeting.

Common fractions and decimals

Spell out common fractions and use hyphens between the words. Use numerals for decimals. For example:

  • Two-thirds of the budget was allocated, but the project requires half a million dollars.

  • Travis County roads only account for 0.07 percent of the total traffic incidents in Texas in the last month.

Ages, percentages, and monetary values

Use numerals for ages, percentages, and monetary values. For example:

  • The Task Force celebrated its 30th anniversary.

  • The approval rate is 25%.

  • The budget is $10.99 million.

Dates and times

Use numerals for dates and times. Write times with "am" and "pm" in lowercase and without periods. Use a comma before the year in a complete date. For example:

  • The meeting is scheduled for June 15, 2023, at 2:00 pm.

Measurements and units

Use numerals for measurements and units. For example:

  • Parks staff recorded a new high temperature at the sports complex stadium of 104°F.

  • Parks staff need cement blocks that measure 12 inches by 8 inches for their gardening project.

Consistency within the same sentence

When numbers appear within the same sentence, maintain consistency. Use numerals for all numbers to maintain uniformity. For example:

  • There are 10 reports on the agenda and 15 votes to be counted.

Punctuation

Punctuation is an important element in written communication, shaping the structure and clarity of our messages. Familiarize yourself with the following rules to enhance the effectiveness of your writing and maintain a polished and professional tone.

Apostrophes

The method of indicating possession depends on the type of word being used.

...

Remember to add an extra "s" after the possessive apostrophe for singular common nouns ending in "s." In all other cases, including plural common nouns and singular proper nouns, only use the apostrophe after the final "s."

Parentheses

The overuse of parentheses often indicates that a sentence is becoming convoluted. Whenever possible, try to rephrase the sentence. If incidental information is necessary, commas or two dashes are often more effective alternatives. Use these alternatives whenever feasible.

...

  • Place a period outside the closing parenthesis if the material inside is not a complete sentence (such as this fragment). (An independent parenthetical sentence, like this one, takes a period before the closing parenthesis.)

  • When a phrase placed in parentheses (like this one) could qualify as a complete sentence but depends on the surrounding material, do not capitalize the first word or end with a period.

  • Do not use parentheses to denote a political figure's party affiliation and jurisdiction. Instead, set them off with commas.

Time

To ensure clarity and consistency, follow the guidelines below to represent time.

Time Format

Use a 12-hour clock format and indicate am or pm in lowercase letters without periods. For example, 2:00 pm. Only include minutes if necessary. If minutes are included, use this format for all times in the section.

Special Cases

Write out "noon" or "midnight" instead of using numerical representation. E.g., The commission will stop accepting applications on Friday at noon.

Time Range

Use "am" for times from 12:00 am (midnight) to 11:59 am. Use "pm" for times from 12:00 pm (noon) to 11:59 pm.

Hours of Operation

When specifying hours of operation, include both the start and end times, along with the am or pm designation.

  • Example: Monday, 7:30 am to 5:00 pm.

  • Example: Monday to Friday, 9:00 am to 5:00 pm.

Tone

Maintaining an appropriate tone in writing is critical for effective communication, particularly in the context of government organizations. The tone should reflect the values and standards of our organization while adhering to principles such as active voice and plain language. Consider the guidelines below when crafting your content.

Active Voice

Travis County staff should always strive to write in active voice. Active voice makes the subject of the sentence perform the action, resulting in clearer and more direct communication. For example:

  • The department implemented the new policy to enhance public service efficiency.

Passive Voice

While active voice is preferred, there may be situations where passive voice is more appropriate or necessary. However, use passive voice sparingly and only when it enhances clarity or emphasizes the receiver of the action.

  • The public input process began last March to gather feedback on the proposed development.

Plain Language

Plain language is a writing style that emphasizes clarity, simplicity, and accessibility to a wide range of readers. While staff may be highly familiarized with specific subject matter, we must not assume the general public is. Information must be made accessible and easy to understand for all audiences. Consider the best practices below.

...

  • The new policy will be effective starting next month. It means that residents can register their vehicles online.

Tone Consistency

Maintain a consistent tone throughout your writing to establish a cohesive and professional voice, especially when communicating government policies and information.

...