You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

In general, UGS follows The University of Texas Writer's Style Guide.

Here are some common formatting, style, grammar, and punctuation issues you might encounter.

View the Drupal cheat sheet

**If you will be updating webpages and have not been trained in Drupal, please contact Trent Lesikar to schedule training**

Common Style Issues

Capitalization and Punctuation

  • Always capitalize “The” in “The University of Texas”.
    • Also, “UT” is acceptable, not “UT Austin”
  • Never capitalize “university”, “school”, or “college” mid-sentence unless using a proper name.
    • “I work for The University of Texas at Austin. The university is a good employer.”
  • Never capitalize “the” in “the School of Undergraduate Studies” mid-sentence.
  • Never capitalize the semester name (e.g. spring, summer, fall) mid-sentence.
  • Never capitalize a subject or department unless using a proper name or a course title.
    • CORRECT: “Students can enroll in chemistry courses from the College of Natural Sciences.”
    • CORRECT: “She majored in physics and English.”
    • CORRECT: “She is a faculty member in the Department of Sociology.”
    • CORRECT: “She is a faculty member in the sociology department.”
    • INCORRECT: “He is taking Chemistry, Art History, and Biology courses this semester.”
  • Never capitalize “bachelor’s” or “master’s” degree mid-sentence.
  • Always use punctuation in degree abbreviations.
    • For example: Ph.D., M.A., M.Ed., etc.
  • Always use the Oxford comma with a list of three or more things.
    • CORRECT: “She is taking art history, biology, and math courses this semester.”
    • INCORRECT: “He is majoring in English, biology and Spanish.”
  • Capitalize job titles only when used before a name
    • CORRECT: “Brent Iverson is dean of the School of Undergraduate Studies.”
    • CORRECT: “Dean Brent Iverson will attend the luncheon hosted by President Fenves.”
    • INCORRECT: “The President spoke at our dinner on Tuesday night.”

Dates, Times, and Numbers

  • Use the following formats for times: “4-5 p.m.” / “2:30 a.m.-5 p.m.” / “4:30-5:30 p.m.”
  • Use the following formats for dates: “Sept. 1, 2017” / “September 2017” / “Thursday, Sept. 2, 2017”
  • Never use suffixes with dates e.g. “Oct. 3rd” or “Nov. 4th
  • Never use parenthesis with phone numbers
    • CORRECT: 512-471-4486
    • INCORRECT: (512) 471-4486
  • Always spell out numbers one through ten. Use numerals from 11 on.

Never use two spaces after a period

Use ampersands in page and program titles but not within body text, unless referencing a page or program title

Always link email addresses to names or prompts when available

  • For example: “Please email us or call 512-471-8800 for more information.”

 Program-specific Styles

Bridging Disciplines Programs

  • Certificate titles do not use the Oxford comma
    • For example: “Ethics & Leadership in Law, Politics & Government”
  • Always capitalize “Connecting Experience”  

First-Year Experience

  • When capitalizing a program title, consider its acronym
    • Examples: First-year Interest Group (FIG), First-Year Experience (FYE), Transfer-Year Experience (TYE)
  • Always capitalize 360 Connection, Signature Course, and University Lecture Series

 Headings 

  • Every header should have text underneath it.
    • Do not place an h2 directly under an h1. There must be at least one sentence under an h1 before an h2 is used.
  • Use h2 for section titles and h3 for subsections.
    • Don not skip from using an h1 to an h3.
  • A page’s call to action (fill out this form, make an appointment, attend this workshop) should be at the top of the page with the text hyperlinked to any relevant form or contact info.
  • Try to incorporate links into the body of your text.
  • Each page should speak to one audience.
    • For example, there should not be information for students and information for faculty on one page.
  • Keep paragraphs short with one main idea that is summarized in the heading.
  • The entirety of a page’s content should fit on one screen without having to scroll. If there is a lot of excess content that you really can’t cut, make a new page and link to it within the text.
  • Link building names on your pages to their corresponding online maps on first reference.
    • For example, "Visit the Office of the Dean in MAI 202."
    • There is no need to include a link to the same building if it is mentioned multiple times on one page. 

Bulleted and numbered lists 

  • Do not put periods at the end of a bullet (should ideally be phrases, not sentences)
  • Do not put a colon at the end of the text preceding the list
  • Try to use either bold or bullets to make text stand out, not both

PDFs

  • Avoid asking people to download PDFs from the UGS website. Instead, revise the content and put it directly on the web so it can be viewed without downloading.
    • Exceptions include forms or checklists that students are expected to print out and complete.
  • Internal content for use by staff can be posted, revised, and updated on a wiki rather than on the public website.
  • Avoid using "Frequently Asked Questions" pages as a way to organize information on your site.
  • If information is requested often enough to be included as an FAQ, it should be addressed in the front-facing content of your site. 
  • Use emphasis sparingly; it loses its impact if used too much on one page.
  • Never double up on styles (for example, bolding and italicizing a word).
  • Never use exclamation points, unless they appear in a quote. 

FAQ

  • Avoid using "Frequently Asked Questions" pages as a way to organize information on your site.
  • If information is requested often enough to be included as an FAQ, it should be addressed in the front-facing content of your site. 

Emphasis

  • Use emphasis sparingly; it loses its impact if used too much on one page.
  • Never double up on styles (for example, bolding and italicizing a word).
  • Never use exclamation points, unless they appear in a quote. 
  • No labels