IEEE Main Site Style Guide | Printer Friendly |
The IEEE Main Site is the first interaction many people have with the IEEE. It is important that visiting the site is a positive experience. This guide defines the standards and conventions to be used when developing content for IEEE.org in order to create the following:
- consistent, comprehensible presentation of content;
- navigational consistency and context regardless of where a user enters or exits the site;
- unified tone and terminology across the organization.
As a result, visitors to the site can concentrate on content and accomplish their tasks more easily.
Table of contents
|
Click the topic of interest below to review related styles and standards.
|
User-centered content
|
Usability is the ease with which people can employ a specific tool or object in order to achieve a particular goal. Sites designed with human psychology and physiology in mind are deemed highly usable. Creating a highly usable site is a primary objective for the IEEE for the following reasons:
Before you begin to write any content, consider the following.
|
Accessibility
|
As of 1998, under Section 508 (29 U.S.C. ‘794d), Federal agencies must give disabled employees and members of the public access to information that is comparable to the access available to others. IEEE strives to maintain a Web presence in accordance with Section 508, so as not to further an individual's ability to obtain and use IEEE information quickly and easily. You can assist with this process by adhering to the following: W3C outlines the major components of accessibility on the Web:
508-compliant sites offer significant advantages that go beyond accessibility. For example, those with "text-only" options provide a faster downloading alternative and can facilitate transmission of web-based data to cell phones and personal digital assistants. More information about creating accessible Web content can be found at the Section 508 Web site. For additional resources, visit: |
Look and feel
|
Consistency is the cornerstone of usability. As the user moves through a site, the visual treatment provides instant reassurance that they are still in the same place, and gives an overall impression of professionalism and reliability. Visual treatment applies not only to obvious elements like logos and navigation, but also to content elements, fonts, and backgrounds. Both internal and external consistency should be considered.
Tone and voice Although IEEE Web publishers often think of their web pages as an individual site, they are actually just a section of the overall IEEE Web site. As visitors move from page to page on the site, they should not be aware that different areas of content have been developed by different individuals. Here are some guidelines and best practices all IEEE publishers should follow to provide a seamless experience and a consistent voice for site visitors.
table of contents
Avoid adding an apostrophe to the name IEEE, such as "IEEE's publication…" Instead use “... publication of IEEE.” Use “IEEE,” not the “Institute of Electrical and Electronics Engineers” or “the Institute.” Use “IEEE” not “we” or "our,” but only use IEEE when referring to an activity or policy of the overall organization. When “IEEE” is part of the name of a product, publication, service, society or other title, it should never be dropped. This applies to first and subsequent references. (Examples: IEEE Xplore®, IEEE Spectrum, IEEE Computer Society)
table of contents
Usage of the following browser-safe color palette—which will automatically be applied to unformatted text in the content management system through cascading style sheets—ensures that pages remain consistent, user friendly, and visually appealing. Use of these colors for purposes other than those specified, or use of colors not included on the palette, should be approved by the Web team.
Cascading style sheets (CSS) globally control text formatting for the site to allow site-wide changes to font style, color, and size via one edit to the style sheet. When creating content in CMS, accept all default fonts rather than changing fonts within the applet which will override the style sheets. Often when you migrate text from another environment into CMS, the system retains the original formatting. This results in display inconsistencies and disables the text resizing tool. Open a Help Desk ticket if you need help returning fonts to the default settings. To avoid this problem, first "Paste" content into a program such as Notepad which will clear all formatting. Then you can "Copy" the content out of Notepad to "Paste" into CMS. Page templates are used to allow IEEE Web publishers to display elements consistently throughout the site. They unify the look and feel of non-editable page elements, such as:
as well as editable page elements such as:
|
Creating Web pages
|
Depending on the type of content, there are different layout options with varying levels of navigation including:
Unlike the names of files on your personal computer, the names of your files and folders in the content management system are not purely for your own reference. The names help users understand where they are within the Web site, and to navigate back to particular content. The names also appear within the URL address. The following guidelines should be used:
Short pages, those containing one or two screens of text at most, work best for the first few levels of a Web site where users are scanning for link choices. Longer pages (those that require more scrolling) may be more acceptable deeper within the site where related content can be printed and read later. The primary measure of page length should be content. Think through your material; create logical divisions and subdivisions based on the structure of your information. You should not arbitrarily divide your information simply to conform to acceptable page length. When creating deeper pages within the site, where scrolling may not be avoidable, the following devices should be considered to make the content more easily readable and navigable:
Landing pages are the "home" or "index" pages within a Web site section. There is only one landing page for each section. Generally speaking, short pages containing one or two screens of text at most, work best for the first few levels of a Web site where users are scanning for link choices. Landing pages should serve as an overview for the section and may also introduce the newest information added or changes to the site section.
Place images and text on pages in a way that creates a clear visual hierarchy in order to :
The IEEE Web site uses left alignment for headings, sub-headings and text. Centered text prevents the user from quickly scanning down a single column on a page. To follow are some ways to show importance or priority.
To follow are some ways to show relationships between content.
Other tips for creating a more readable, interesting page layout include:
Lines of text should be no longer than half the width of the screen. Using the three-column template in the content management system of the IEEE Web site will ensure that your copy is not too wide. This option can be used regardless of whether you are planning to have right column content.
Follow these guidelines when designing an interactive user experience:
|
Planning Content for Page: Overview
|
Content is defined as any piece of information. Here are some examples of page elements that may individually or collectively be considered content:
Page elements have content implications, but will be addressed separately from content in this guide. Page elements, which help organize and synthesize content, include:
table of contents
Short pages, those containing one or two screens of text at most, work best for the first few levels of a Web site where users are scanning for link choices. Longer pages (those that require more scrolling) may be more acceptable deeper within the site where related content can be printed and read later. The primary measure of page length should be content. Think through your material; create logical divisions and subdivisions based on the structure of your information. You should not arbitrarily divide your information simply to conform to acceptable page length. When creating deeper pages within the site, where scrolling may not be avoidable, the following devices should be considered to make the content more easily readable and navigable:
table of contents
Using content from someone else’s Web site without asking permission is considered copyright infringement even if the copied content does not display a copyright notice. In the US, practically everything considered a private work and created after 1 April 1989 is copyrighted and protected, whether or not it has a notice. This also applies to pictures and graphics, as well as scanned pictures from magazines.
Update pages regularly in order to keep information timely and accurate. Data such as statistics, numbers, and examples all need to be recent and up-to-date. If such information is outdated, your credibility and the credibility of your pages suffers. Users will be less apt to trust any information they come across on a site if some of the information is found to be outdated. For content housed within the IEEE Content Management System, a mechanism is provided to associate expiration dates with objects. This will assist you in keeping content current. |
Writing Content for the Web
|
Writing for the Web is very different than writing for print. You cannot simply move your print documents onto Web pages. This would not be using the medium to its best advantage. Developing content for a Web site very often means writing new material. Web readers typically do not read a page from start to finish on the computer screen. Instead, they scan a site for relevant items and then print the information for later use. Generally speaking, word count of a written piece for the Web should be about half the word count used when writing for print.
table of contents
If your topic includes extensive information, dividing it into multiple pages may make it easier to read online. However, many people prefer to read lengthy or complicated texts offline. Multiple pages will make it harder for users to print your information. Therefore, if your content is likely to be printed, either present it as a single Web page or divide it into subdivisions. The user will be able to print the content using the "printer friendly" icon.
table of contents
When describing something a user can do on the Web site, describe it in terms the user would use or easily understand. The imperative voice (commanding) is attention-grabbing and helpful, so it should go at the front of a phrase, i.e., "Find XYZ here," "Subscribe to XYZ," "Place order." The user likes to feel like he or she is in control. English is the default language for IEEE Web pages, and all content should reflect this. If you would like more information on Web page translation or would like to see a list of IEEE sites in other languages, please visit the IEEE Transnational Resources page.
table of contents
Since users can enter a Web site at any page and move between pages as they chose, every page should be independent. Explain the topic of each page without making assumptions about the previous page seen by the user. Links to background or explanatory information help users who do not have the necessary knowledge to understand the page itself.
table of contents
The following tactics will help ensure that Web readers will maximize the information you are presenting to them.
table of contents
Follow these guidelines when presenting your content in a list format.
table of contents
When using statistical data on your page, make sure the information is current and up-to-date. All statistical data should be accompanied by the source from which it was derived along with the date the data was compiled.
table of contents
table of contents
When using a number between zero and ten, spell out the number (i.e., “3” or "10"). When using any number higher than ten, use the numeric version (i.e., "12" or “300”).
table of contents
Change all British spellings to American spellings. In particular, watch for “our” endings in words like:
“re” endings in words like:
“s” rather than “z” in words like:
“gue” rather than “og” in words like:
table of contents
Adhere to standard grammar and punctuation rules when it comes to pluralization of typical words. The plural of calendar years do not take the apostrophe before the “s.” For example, the plural form of 1990 is 1990s.
table of contents
The hyphen is the shortest of the three and is used most commonly to combine words (compounds such as "well-being" and "advanced-level," for example) and to separate numbers that are not inclusive (phone numbers and Social Security numbers, for example). The en dash is slightly longer than the hyphen but not as long as the em dash. (It is, in fact, the width of a typesetter's letter "N," whereas the em dash is the width of the letter "M"—thus their names.) The en dash represents the words “to,” “through,” or “and.” Use it between page numbers, years, names, a range of values, or for opposites. For example:
When using the en dash to represent a range, if the word “from” occurs, the word “to” must be used rather than the en dash (i.e., “ranges from 5 to 50 times”). The em dash, is used in ordinary writing to mark a suspension of the sentence. It is also used like parentheses, to mark a subordinate thought within a sentence. For example: •
The meeting was long—one volunteer fell
asleep—but productive. Words that are often confused affect:
to change or modify (verb)
alternate: a substitute among: relationship involving more than two things between: relationship involving two things compare
to: point out resemblance between different
objects compose:
to create or put together farther:
distance fewer:
modifies plural nouns specifying countable units,
e.g., fewer tubes imply:
something suggested though not expressed number: a
large number of people
principal: chief, main, most important
(adjective) precede:
come before that:
(defining, restrictive) |
Effective Use of Graphics and Images
|
Graphic elements on a page are an important part of a visitor's impression of the IEEE Web site and, consequently, of the IEEE brand. Graphics should only be added after careful consideration has determined that they align with the overall look of the Web site and add value to the user experience. Usability testing shows that clip-art and stock photography is not valued by many of our users, and should therefore be avoided in favor of "real" images that help to illustrate a point, or in favor of no imagery. When images are used, captions should be included to clearly and specifically explain what is being shown.
Images should be used sparingly to enhance the written content and add to the visual interest of the page. IEEE.org users like images that have an obvious purpose. Be tasteful and don't let images overwhelm the user.
There are a variety of software packages available to assist you in compressing your graphics for use on the Web, including NetMechanic Acceleration GIFBot and Macromedia Fireworks. Visit NetMechanic and download GIFBot software for free. It will compress both JPEGs and GIFs by up to 90%. The following online tutorials offer information on optimizing your graphics for the Web.
Web
Reference's Graphics Optimization
Just as your folder names created in the content management system will become part of the content URL, graphic file names will as well. For this reason, many of the same naming guidelines apply.
Captions should be used to help the user understand the context, content, and source of the image. Currently there is no special entry field in the content management system for captioning images. The best method for captioning graphics that appear within a column of text is to place the graphic and the text into a table. This will allow you to place the caption directly below the image, without impacting the body copy.
It is important to provide meaningful text substitutes for users who don't display images. For example, when picturing the medal of honor recipient, use "IEEE Medal of Honor recipient" instead of simply "man." Alt tags can be used to give both disabled and non-disabled users a higher confidence that what they are clicking on will bring them to their desired destination.
IEEE Corporate Web Team pages should have a white background. Background graphics should be avoided. Do not use GIF animation except in very special circumstances (i.e., instructional purposes) with Web team permission, due to its distracting nature and effect on file size.
Information regarding use of the IEEE Master Brand (logo) is available in the Brand Identity Toolkit section of the Web site. If you have questions, please contact the IEEE Corporate Strategy and Communications team. It is not appropriate to incorporate the IEEE Master Brand into background or wallpaper treatments.
Using content from someone else’s Web site without asking permission is considered copyright infringement even if the copied content does not display a copyright notice. In the U.S., practically everything considered a private work and created after 1 April 1989 is copyrighted and protected whether it has a notice or not. This also applies to pictures and graphics, as well as scanned pictures from magazines.
table of contents |
Navigation and Linking Guidelines
|
Navigation elements are meant to help users transition between different areas of the site with relative ease.
Left column content Global left navigation is created through a central file in the content management system. All content within a directory inherits common left navigation. The left column can include an expandable navigation menu and/or a flexible layout module.
Additional navigation section module Use this template to create and format global content in the left column of your Web page that you would like to appear on all of your Web pages within a given folder.
Local left navigation In addition to global left navigation, content-specific navigation can exist in the left column. This module lets you create layouts with:
Right Navigation Module: This element is optional and can be created either globally (and applied dynamically to all content within a particular directory) or applied to an individual file. Multiple right navigation modules can be created. Right column content There are two types of global module used in the right side column: the Global What Module and the Global Right Module. You can also add local right column content to this column. Global “What” Use this template to create and format content within the right column of your Web page (right sidebar navigation and formatted content). By default, this module is located in the upper right hand side of your Web page; also by default the header of this module is named “What do you want to do?” This module can consist of any combination of the following:
Use the "What Do You Want To Do" menu to provide the user with links to related content that is either:
This menu should not be used to duplicate links in the Global Navigation Menu. Usability studies show that this redundancy is confusing to the user. What do you want to do? Navigation: This module is generally inserted at the top right of the page layout and is designed to provide visitors with an easy way to find content. Links may be based on usage statistics and could include difficult to find content within the section, or related content in another section of the Web site. Global right This “global” module will display on all Web pages within a given folder. Each folder can have a unique Global Right Module if necessary. Up to five global right modules can be included on your Web page. This module allows you to provide links to commonly accessed areas of your page or portal based on web analytics. Each may consist of any combination of the following:
*Related links are displayed in the right side column but are created using the generic content template which controls the content for the “main area” content. Right Navigation: In addition to global right navigation, content-specific navigation can be created in the right column with the following layout formats:
Consistency makes sites easier to use, because visitors don't have to learn new tricks as they move around. This is particularly important when planning navigation, as it is one of the first and most commonly used tools on any page of a Web site. Please follow these guidelines.
When the user must scroll in order to view all page content and/or content "below the fold" is not obvious from the page title, anchor links should be used to inform the user of all content topics included within the page. The table of contents at the top of this Style Guide is an example of how anchor links can be used to improve usability. Basic navigation and link naming conventions apply to anchor links. When anchor links are used, "top of page" options should also be provided at the bottom of each topic. Note: Formerly, "back" was accepted use for top of page links, however this has been shown to cause confusion with the browser "back" button. The preferred language is now "top of page."
Breadcrumb navigation on internal site pages provides additional orientation to users. A breadcrumb trail is a special kind of navigation bar, featuring a hierarchical row of links. As the user moves deeper into the site, the breadcrumb trail should show the closest direct path back to the home page. These elements are based on which of the Informational Portals the content resides within. The breadcrumb navigation provides visitors both a method of determining where they are on the site and a means to link back to the Section Home Page or IEEE Home Page.
The IEEE offers two types of redirects. Guidelines for redirect use are currently under development. To learn more about redirects, visit the IEEE URL Redirect Registration page of the site. table of contentsSupporting files Supporting files include PDFs, Word, Excel, PowerPoint, and Windows Media Video files. When possible, HTML Web pages should be used instead of supporting files. Supporting files should not be used as a way to quickly get content on the Web, but rather when appropriate and beneficial to the user’s experience. Keeping usability in mind, follow these rules for supporting files:
|
Miscellaneous
|
Advertising on IEEE Web pages is restricted for the following reasons:
Contact the Web Team (ieee-web-team@ieee.org) with any questions regarding specific advertising issues. |


