Written Document Design

All documents have a purpose—to persuade, inform, instruct—but the first and foremost purpose of any document is to be read. The way your document looks on a page or screen determines how fully and carefully your audience reads it.  Good design will help your audience get the message you want them to receive and achieve your intended purpose. Remember that people do not read reports or proposals for pleasure; they read them because they have to – it’s part of their job. And since “time is money,” the longer it takes to read the document, the higher the “cost.” When you design a document, your job is to make your audience’s reading process as easy, clear, and efficient as possible by using elements that make your document user friendly.

General design elements to consider include the following:

  • White Space & Margins
  • Headings
  • Lists
  • Figures & Tables
  • Fonts
  • Cover/Title Page
  • Table of Contents/List of Figures

White Space & Margins

Always make sure that a page has enough white space so that information does not look crammed onto the page. Readers tend not to read when there are large blocks of type. Look at the two figures below – just let your eye scan over the documents (reading the content does not matter).  Based solely on the way each document looks, which one would you rather read?

Page Excerpt from a typical Academic Essay with the first line of paragraphs indented, double spaced text, a block in the top corner with the student's name, course number, instructor and date, and a centered title.
Figure 1 Excerpt from an Essay
Excerpt from a Technical Report; document includes headings and sub-headings, a figure, a bullet list and a labelled list.
Figure 2 Excerpt from a Technical Report

Follow these guidelines to use white space effectively, so that you have a “clean” looking, easy-to-read document:

  • Use margins of approximately 1 inch all around. (Note that if you are binding your report, use a 2 inch left margin.)
  • Break up lengthy paragraphs into short ones, so that you don’t have large, difficult-to-read blocks of type.
  • Use headings to introduce sections of text.
  • Start all paragraphs on the left-hand margin; do not indent paragraphs.
  • Single-space your text, but leave a double space between paragraphs.
  • Align your text to your left-hand margin (called left-justifying), leaving a “ragged” right margin.  Never justify both left- and right-hand margins, as this creates strange spacing of words and sentences that makes your text hard to read.

Headings

Headings are standard features of technical documents that serve several important functions:

  • Provide organizational overview of the document
  • Show logical development of ideas
  • Show hierarchical relationship of ideas (headings, sub-headings)
  • Allow the reader to scan and read selectively
  • Increase readability of the document by providing breaks and white space.

When designing the headings in your document, keep in mind these general principles:

Hierarchical Relationship of Ideas

Use font size, boldness, typography, and color to indicate the relative importance of ideas and how they interconnect. In general, first level headings are larger and bolder than second and subsequent level headings.

Consistency

If you use headings, every section must have a heading. Make sure your headings at each level are consistent in design (font, size, color, etc.)  Use consistent, parallel phrasing as well.

Readability

Leave white space above and below headings. There should always be slightly more space above the heading than below it. As a general guideline, use 2-4 headings per page in short reports. Avoid overusing headings. Note that if you use a heading, there should always be some text below it.

Specificity

Use headings that directly and clearly inform the reader of the content of each section. For formal reports, descriptive headings are useful.  Descriptive headings succinctly explain the content of each section.  For proposals or other documents that have relatively consistent structures, use functional headings to clearly indicate each section.  The figure below provides examples of functional and descriptive headings.

             Functional Headings – for Proposals                                        Descriptive Headings – for Reports

the box on the left shows a table of contents using only function-based headings (Introduction, Problem Definition, Proposed Solution, Benefits, Conclusion, Recommendation, References, Table 1, Figure 1). The box on the right contains a table of contents using descriptive headings and captions (Ski Lift Safety Issues, Deropement Problems in Tow Lifts, Proposed Rope Catcher Solution, Benefits of Implementation, Resolving the Safety Issues, Recommendation, References, Table 1 Cost breakdown for one tower installation, Figure 1 Proposed Retainment Device).

Placement

Avoid creating “widows and orphans” by leaving a heading at the bottom of the page with no body text below it. Insert a page break before your heading to avoid this.

Lists

Lists, when used correctly, are powerful tools to enhance readability.  Lists allow you to emphasize important ideas, simplify long sentences or paragraphs, and help you add white space to make reading more pleasant.

Follow these guidelines when creating lists of any kind:

  • Include between 2-8 items in a list. You must have at least two items in a list (or it’s not a list; it’s just an item). Avoid having more than 8 items in a list, as too many items can have the reverse effect.  If you emphasize too many ideas, you end up emphasizing nothing. NASA recommends no more than 8 steps in an emergency procedure; more than 8 can be overwhelming in a crisis situation.
  • Avoid splitting a list over two pages.
  • Set a list in context, with text that explains and/or introduces the nature of the list.
  • Use parallel phrasing for each listed item (note that each item in this list starts with a verb).

Common Types of Lists

There are five commonly used types of lists:

  1. bulleted
  2. numbered
  3. in-sentence
  4. labeled
  5. nested

Bulleted Lists

Bulleted lists are the most commonly used kind of list. They are effective when:

  • You want to emphasize two or more items
  • You can place the items in any order (no particular order is required)
  • You want to add white space to your document to enhance readability

Bulleted list items should generally be short (a word or a phrase). If you find your bulleted items are longer than this, consider using another kind of list, such as a labeled list or a nested list.

Numbered Lists

Use numbered lists when the order of the listed items is important and ideas must be expressed in chronological order. For example, use a numbered list when you must provide a series of steps in instructions, or when you are introducing ideas that will be discussed in a certain order in the following text. If you have a list of more than approximately 8 items, consider breaking up the list in two or more stages or categories (Steps in Stage 1, Steps in Stage 2, etc.).

In-Sentence Lists

Use in-sentence lists when you want to: a) maintain paragraph style, b) avoid having too many lists on one page, and c) keep the list items relatively short. The previous sentence is an example of an in-sentence list. Note that you can use a lower-case letter with a parenthesis after it to introduce each item.  Sometimes in-sentence lists are combined with numbered lists if the list items are short and need to show a chronology.

Labeled Lists

Use a labeled list when you are listing items that need further explanation. Start the list item with the word or term (the “label”), followed by a colon. Provide the brief explanation after the label, as part of the list item.  Make sure the label portions (before the colon) are phrased consistently; try to make the explanations that follow roughly equal in length and detail. Labeled lists may also be bulleted or numbered.

sample labeled lists

The project documentation consists of three main reports:

  1. Report One: an internal, informal proposal
  2. Report Two: an informative project plan
  3. Report Three: an final analysis of the project development, enactment, and implementation

 

The project also includes requires two oral presentations:

  • Presentation 1: feasibility of project, presented to top management
  • Presentation 2: project kick-off, presented digitally to all employees

Nested Lists

A nested list is a list-within-a-list or a list with sub-listed items. Nested lists can be useful for avoiding overly long bulleted lists by categorizing items into sub-lists. Note the long bullet list on the left does not effectively categorize items, so emphasis is lost. The nested list is more effective.

 

Simple Bullet List (too long) Sample Nested List

Every restaurant should contain the following beverage containers:

  • Coffee cups/mugs
  • Latte bowls
  • Tea cups
  • Travel mugs
  • Water glasses
  • Red Wine glasses
  • White wine glasses
  • Beer glasses
  • Beer steins
  • Cocktail glasses
  • Shot glasses
  • Reusable plastic cups.

(12 items is too many for one list!)

Every restaurant should contain the following kinds of beverage containers:

  • Hot beverage containers

    • Coffee mugs/cups
    • Latte bowls
    • Tea cups
    • Travel mugs
  • Cold beverage containers

    • Water glasses
    • Red wine glasses
    • White wine glasses
    • Beer glasses
    • Beer steins
    • Cocktail glasses
    • Shot glasses
    • Reusable plastic cups.

Figures & Tables

Link to fuller information about creating and using visuals in the Using Visuals section of this text.

When placing figures and tables within a document, good design requires that you label them with numbered captions that clearly identify and describe them.  Figure captions are generally placed below the figures (images, graphs, etc.) while table captions are usually placed above the tables. This is because we generally read tables from the top down, and therefore want to see the caption at the top. On the other hand, figures are not always read top down – usually, when you see a figure, your eye goes to the image first, and then the caption, so it is placed below. If you prefer consistency in captioning, which is an option, then place both figure and table captions at the top consistently throughout your document.

Label each figure or table with the word “Figure” or “Table” and a descriptive caption, and number them sequentially but separately, e.g., Table 1, Table 2, Table 3 and Figure 1, Figure 2, Figure 3.

Finally, if you are using a table or figure from a source (not something that you created yourself), make sure to refer to that source in your caption, and document it, e.g., Figure 1. Network Design [1].  Include the full citation at the bottom of the page or, if there are many figures and tables, in a list at the end of the document.

Emphasis

There are times when you will want to add emphasis to a word, phrase, or statistic so that it stands out from the surrounding text. The use of visual aids in your writing can be an excellent option, and can reinforce the written discussion. For example, if you write that sales are up 4% over this time last year, the number alone may not get the attention it deserves. If, however, near the text section you feature a bar graph showing sales growth, you reinforce the statistic.

You may also want to add emphasis with bolditalics, underlining, highlights, bullets, or other options such as different fonts. However, use these emphasis strategies sparingly, so that you really do make small pieces of information stand out and don’t overwhelm your reader with too many special effects.

    Fonts

    Using an appropriate type font increases readability.  There are two basic types of font, serif and sans serif:

    Serif Fonts have little lines which extend the edges of the letters. They have traditionally been used for longer printed texts, as the extension on the letters to help the eye move from word to word. A standard serif font is Times New Roman.; Sans serif fonts do not have lines that extent the edges of letters. They are used for digital texts, although they are being used more and more for longer printed texts. Standard serif fonts are Calibri and Arial.

    Follow these guidelines for fonts to enhance your document’s readability:

    • Always use a standard font, such as Times New Roman or Calibri.  Other fonts will be harder for your audience to read.
    • In most cases, use one main type of font throughout your document.  If you want to mix fonts, then do not use more than two types in one document.
    • If you use two font types, the general practice is to use sans serif for headings and serif for the text.
    • Apply special effects sparingly, if at all.  Confine effects to bold, italics, and underlining, but use these effects only if needed to highlight individual words or very small pieces of text.  Overusing special effects will work against your need to highlight particular information.
    • Choose an appropriate type size.  Most text should be in 12-pt. size, while headings would be larger (perhaps 16- pt. size, depending on the document) and often bold. Subheadings might be 14-pt. size, or they may be 12-pt. bold.

    Cover/Title Page

    Almost all formal reports have a Cover or Title Page, perhaps both. These two pages are used in nearly identical ways, yet some report types or organizations require both with a slight modification to the page’s purpose.

    A cover page is a very simple, precise, brief way to introduce your report to the reader. This should contain:

    • A specific title in large font
    • Company name
    • Name of the author(s)
    • Date of the report

    Sometimes an image is included on the cover page, and sometimes it is not – it depends on your group or organization’s format expectations as well as your own level of design expertise.

    A title page may be used as a cover page; it repeats the information on the cover, but may add more detail.  Additional details that may be added on a title page include the following: report number if the report is part of a sequence, additional author information (e.g., titles, contact information), name and address of the supervisor, and the name and address of the organization that supported the report.

    Here are examples of cover and title pages; either one is fine for a formal report.

    Image of a sample cover page on the left and title page on the right. The cover page is green with the image of a energy efficient lightbulb with the text below "Energy-efficient guide Employing energy- efficient building strategies in residential home." The title page on the left is a white page with the text "Energy-efficient guide Employing energy- efficient building strategies in residential home." and lists the contact information of the company that created the guide.

    Table of Contents

    The table of contents is typically one of the last sections of the document to be created, since it relies on the body of the report. It provides a way of finding information in the report very quickly. In creating a table of contents, you have a number of design decisions:

    • Levels of headings to include: In longer reports, consider only including the top two levels of headings. This keeps the table of contents from becoming long and unwieldy.
    • Indentation, spacing, and capitalization: Notice in the sample that items in each of the three levels of headings are aligned with each other and page numbers are right-aligned with each other. Notice also the capitalization: Main chapters or sections are all caps; first-level headings use initial caps on each main word; lower-level sections use initial caps on the first word only.
    • Vertical spacing: Notice that the first-level sections have extra space above and below, which increases readability.
    • Wording: Make sure that the headings are worded exactly the same as they are in the text. As you write and revise, you might change some of the headings—don’t forget to change the table of contents accordingly.

    Note that if you have a lot of figures and tables, you should also do a list of Figures & Tables after the table of contents.  The same formatting and design characteristics apply.

    Document Design Review

    View the following video to review major concepts of document design.