{"id":1948,"date":"2025-12-19T10:51:20","date_gmt":"2025-12-19T15:51:20","guid":{"rendered":"https:\/\/it.rutgers.edu\/it-communications\/?page_id=1948"},"modified":"2025-12-19T10:51:21","modified_gmt":"2025-12-19T15:51:21","slug":"guidelines-for-writing-about-it-at-rutgers","status":"publish","type":"page","link":"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/","title":{"rendered":"Guidelines for writing about IT at Rutgers"},"content":{"rendered":"    <section class=\"cc--component-container cc--hero-basic  hero-basic color-light-gray\">\n\n<div class=\"c--component c--hero-basic\">\n        \n<div class=\"outer-wrapper\">\n    <div class=\"inner-wrapper\">\n        <div class=\"text-container\">\n            <div class=\"text-wrapper\">\n\t\t\t\t<div class=\"f--field f--page-title \"><h1>Guidelines for writing about IT at Rutgers<\/h1>\n\n<\/div><!-- f--field f--page-title -->\n\t\t\t\t<div class=\"f--field f--text \"><\/div><!-- f--field f--text -->\n            <\/div>\n        <\/div>\n    <\/div>\n<\/div>\n\n\n<\/div><!-- c--component c--hero-basic -->\n\n    <\/section><!-- cc--component-container cc--section -->\n\n\n    <section class=\"cc--component-container cc--rich-text  rich-text\">\n\n<div class=\"c--component c--rich-text\">\n        \n    <div class=\"f--field f--rich-text \"><p>Many of the typical tips for writing also apply when writing about technology.<\/p>\n<ul>\n<li>Be clear and direct.<\/li>\n<li>Know your audience.<\/li>\n<li>Avoid jargon.<\/li>\n<\/ul>\n<p>Of course, this is easier said than done, and writing about information technology presents a number of challenges. How do you provide enough technical details without confusing people? How do you convey technical information without resorting to language understood only by IT experts?<\/p>\n<p>These guidelines are intended for a variety of situations, from email communications to websites.<\/p>\n<h2>Know your audience<\/h2>\n<p>Before you start to write an email announcement, webpage, or other materials, determine your audience.\u00a0<strong>When writing about IT, the key question is often this one: Is this for an IT audience or a general audience?<\/strong>\u00a0You need to know your audience to help you establish the appropriate tone and determine the level of detail for your message.<\/p>\n<p>At Rutgers, here are some of the typical audiences for webpages, email announcements, and other IT communications:<\/p>\n<ul>\n<li>Rutgers IT staff<\/li>\n<li>IT Leadership Council<\/li>\n<li>Students<\/li>\n<li>Faculty<\/li>\n<li>Staff<\/li>\n<li>Users of a specific service (Box, Rutgers Connect, etc.)<\/li>\n<\/ul>\n<p>Additionally, your audience may be limited to a specific location or unit.<\/p>\n<p>Once you\u2019re clear about your audience, you will be in a better position to decide on the content of your message and distribution channels (email, social media, webpage, etc.).<\/p>\n<h2>Create easy-to-scan content<\/h2>\n<p>Provide easily scannable content to keep your readers\u2019 attention. Use these techniques:<\/p>\n<ul>\n<li>Break your information into \u201cchunks\u201d that can be easily accessed and comprehended.<\/li>\n<li>Use heads and subheads to partition your content.<\/li>\n<li>Use blurbs and\u00a0bulleted lists.<\/li>\n<\/ul>\n<h2>Avoid jargon<\/h2>\n<p>Words such as audit, client, domain, machine, and package may have a specific meaning to IT staff and an entirely different meaning outside of IT. Unless you\u2019re writing for an IT audience, avoid specific IT language whenever possible.<\/p>\n<h2>Simplify Rutgers IT<\/h2>\n<p>Aim to simplify IT at Rutgers for your audience. Terms like ESD, TD, and UCS may be familiar to people within IT at Rutgers, but they\u2019re confusing to others.<\/p>\n<p>In general, whether for an IT audience or a more general audience, avoid mentioning more than two organizational layers within OIT, and do not use acronyms for OIT\u2019s divisions (i.e., EI, ESD, etc.) or subdivisions (IdM, TD, etc.).<\/p>\n<p>Do not abbreviate UCM (for unit computing manager) and UCS (unit computing specialist). Spell them out instead so people can understand the full meaning. Outside of IT, those acronyms don\u2019t mean anything.<\/p>\n<h2>Explain the \u201cwhy\u201d<\/h2>\n<p>In email announcements and other communications, explain why a specific action is being taken. This is especially important when we\u2019re decommissioning a service, providing a new service, or planning maintenance.<\/p>\n<p>Write a high-level explanation that emphasizes what is being fixed or improved. Here are some examples:<\/p>\n<ul>\n<li>For data center maintenance and improvements: This work will reduce the risk of outages and make it easier to conduct data center maintenance without major interruptions.<\/li>\n<li>For the choice of Canvas: The move from multiple systems to a single, university-wide learning management system (LMS) will foster collaboration, reduce complexity, and simplify the learning and teaching experience for Rutgers students and faculty.<\/li>\n<\/ul>\n<h2>Write clear subject lines<\/h2>\n<p>When drafting an email, always include a proposed subject line. Subject lines should be clear, direct, and specific; when applicable, use phrases (like \u201caction required\u201d) to get the reader\u2019s attention.<\/p>\n<h2>Proofread your content<\/h2>\n<p>Don\u2019t send out an email announcement or publish a webpage without proofreading your content.<\/p>\n<p>Use a mix of these methods:<\/p>\n<ul>\n<li>Use the spelling and grammar check available in various word-processing tools.<\/li>\n<li>Run your content through\u00a0<a href=\"https:\/\/www.grammarly.com\/\" target=\"_blank\" rel=\"noopener\">Grammarly<\/a>, a free tool for improving writing.<\/li>\n<li>Ask a colleague to review your content.<\/li>\n<\/ul>\n<\/div><!-- f--field f--rich-text -->\n\n    <\/div><!-- c--component c--rich-text -->\n\n    <\/section><!-- cc--component-container cc--section -->\n","protected":false},"excerpt":{"rendered":"","protected":false},"author":257,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"page-category":[],"class_list":["post-1948","page","type-page","status-publish","hentry"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.0 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Guidelines for writing about IT at Rutgers - IT Communications<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Guidelines for writing about IT at Rutgers - IT Communications\" \/>\n<meta property=\"og:url\" content=\"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/\" \/>\n<meta property=\"og:site_name\" content=\"IT Communications\" \/>\n<meta property=\"article:modified_time\" content=\"2025-12-19T15:51:21+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/guidelines-for-writing-about-it-at-rutgers\\\/\",\"url\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/guidelines-for-writing-about-it-at-rutgers\\\/\",\"name\":\"Guidelines for writing about IT at Rutgers - IT Communications\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/#website\"},\"datePublished\":\"2025-12-19T15:51:20+00:00\",\"dateModified\":\"2025-12-19T15:51:21+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/guidelines-for-writing-about-it-at-rutgers\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/guidelines-for-writing-about-it-at-rutgers\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/guidelines-for-writing-about-it-at-rutgers\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"IT Communications\",\"item\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Guidelines for writing about IT at Rutgers\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/#website\",\"url\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/\",\"name\":\"IT Communications\",\"description\":\"A Rutgers IT Service\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/it.rutgers.edu\\\/it-communications\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Guidelines for writing about IT at Rutgers - IT Communications","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/","og_locale":"en_US","og_type":"article","og_title":"Guidelines for writing about IT at Rutgers - IT Communications","og_url":"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/","og_site_name":"IT Communications","article_modified_time":"2025-12-19T15:51:21+00:00","twitter_card":"summary_large_image","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/","url":"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/","name":"Guidelines for writing about IT at Rutgers - IT Communications","isPartOf":{"@id":"https:\/\/it.rutgers.edu\/it-communications\/#website"},"datePublished":"2025-12-19T15:51:20+00:00","dateModified":"2025-12-19T15:51:21+00:00","breadcrumb":{"@id":"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/it.rutgers.edu\/it-communications\/guidelines-for-writing-about-it-at-rutgers\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"IT Communications","item":"https:\/\/it.rutgers.edu\/it-communications\/"},{"@type":"ListItem","position":2,"name":"Guidelines for writing about IT at Rutgers"}]},{"@type":"WebSite","@id":"https:\/\/it.rutgers.edu\/it-communications\/#website","url":"https:\/\/it.rutgers.edu\/it-communications\/","name":"IT Communications","description":"A Rutgers IT Service","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/it.rutgers.edu\/it-communications\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/pages\/1948","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/users\/257"}],"replies":[{"embeddable":true,"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/comments?post=1948"}],"version-history":[{"count":1,"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/pages\/1948\/revisions"}],"predecessor-version":[{"id":1949,"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/pages\/1948\/revisions\/1949"}],"wp:attachment":[{"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/media?parent=1948"}],"wp:term":[{"taxonomy":"page-category","embeddable":true,"href":"https:\/\/it.rutgers.edu\/it-communications\/wp-json\/wp\/v2\/page-category?post=1948"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}