Submission Guidelines: Policy Documentation
- Before Writing
- Document Preparation
- Writing Process
- Headings
- Lists
- Tables
- Hyperlinks
- Acronyms
- Graphical Elements
- After Writing
Before Writing
- Define the purpose of the document.
- Determine if there is a document already in existence that achieves the same purpose.
- Define your audience.
- Are you writing to students, staff, faculty, or a combination?
- What are you assuming about your readers regarding their technical skills?
Document Preparation
- The document must be in one of the following formats:
- HTML
- Word 2007 (PC)
- Word 2008 (Mac)
- text-only
- The file name must be descriptive and contain no spaces.
- Each page must have an introduction or description at the top.
Writing Process
- Do not use cryptic or clever titles. Clear and concise is best.
- The information should be clear and follow a logical order.
Headings
- The uppermost heading tag (H1) is always Information Technology Services.
- Use heading tags rather than font styles to create sections titles. Start with the tag H2 for the main heading, and follow with H3, H4, etc. There can be only one H2 per page.
Lists
- For policies and guidelines, use an ordered list. Use the following formatting standard: capital Roman numeral, capital letter, lowercase Roman numeral, lowercase letter.
- To create indented text underneath a bulleted or numbered point, use the <br> tag, not a <blockquote>.
Tables
- Only use tables for TABULAR DATA. Tabular data is data that is logically organized in rows AND columns.
- Use a summary with each table.
Example: <table summary="Data Services Committees">
- Use table headers to label the information in the columns and rows.
Example: <th>Committee</th>
Hyperlinks
- If the information can be presented concisely on the current page, do not use a hypertext link.
- Give your links descriptive names rather than the actual URL or words such as "click here."
Example: ITS Home Page instead of its.uncg.edu
- Use relative links, not absolute links. A relative link can be used when linking between locations within a Web site. It is created when the href value is relative to the location of the current webpage. An absolute link is one that contains the entire URL.
- Unless you are linking directly to a file, such as a PDF, add a final slash (/) at the end of the path.
- Use anchors to link to information in lengthy documents where scrolling up or down a page is necessary.
Acronyms
You may use acronyms for organization names and terms, provided you write out the full name/term followed by the acronym in parentheses on its first use.
Example: Information Technology Services (ITS)
Graphical Elements
- Avoid using too many screenshots. If a dialog box itself provides instruction to the user, just write the instructions.
- Each image must contain a descriptive alt tag.
- Images should be in JPEG, GIF, or PNG format. They should be no wider than 475 pixels and no taller than 400 pixels.
- The official UNCG colors are Navy (003366), Gold (FFCC00), and White. The Information Technology Services (ITS) templates are designed using these colors because our Web pages are considered to be official University publications.
- Background images and colors (other than white) are generally not permitted. They tend to hinder the readability of a Web page. In some cases, a background color may be used to help distinguish between table elements or for highlighting a menu choice.
- Text links should be set to Navy (003366) when not selected, changing to Gray (999999) when selected.
After Writing
- Have another subject matter expert read your document to ensure its clarity and conciseness.
- Give document to Information Technology Services (ITS) Web team for approval and publication.
NOTE: ITS requires adherence to these guidelines in order for publication to occur. If you have any questions about the standards above, please contact 6-TECH at (336) 256-TECH or 6-TECH@uncg.edu. A member of the ITS Web team will be happy to assist you.