ITS Style Guide
Common writing tasks
There are a few common writing tasks where we try to use consistent language and reference techniques.
Directing users to the UT Service Desk
Always direct users to the UT Service Desk, and not just the Service Desk, since there are Service Desks in other departments on campus.
Say "If [insert phrase describing what user is trying to do], please contact the UT Service Desk." The link for "UT Service Desk" is http://www.utexas.edu/its/helpdesk/. For example:
If you need to change your mailbox name or need more help setting up your address, please contact the UT Service Desk.
Try to direct users to Web resources first, but include the UT Service Desk contact information if it is needed.
Referring to students, faculty, and staff
When writing about our constituents, always list them in this order - students, faculty, and staff.
On the Web, it is appropriate to link within the sentence without directly adding referential language. You should make the title of the page to which you are referring a hyperlink. For example:
For more information, see the Canvas web site.
Style sheets for ITS Web pages will include the full URL after the reference for printed documentation, but in an email or plain text communication where you cannot create hyperlinks, you must include the complete URL.
Use cross references like this judiciously. Sometimes it is better to restate information than to make users look for it elsewhere - it can be frustrating to click through several links to get to the information you need.
When including an e-mail address in a Web page, use this format:
Send an e-mail message to the UT Service Desk at email@example.com.