Primary structure models

Print topic Print topic Previous topic  Next topic

The right structure:

makes it easy to find information for the first time

makes it easy to find information again after some time has passed

presents the information in a didactical order, step by step

helps to shape the mental model of how the product works

There’s no universal structure model that fits all scenarios. Always base your decision on the specific goals and mental models of your audience.

Often, the best solution is a combination of two or more models. You can, for example, use one model for all level 1 headings, and then use different models for the subtopics within each section (level 2 headings).

Try to be as consistent and parallel as possible.

Expand /Collapse All Subsections

General rules

Regardless of which structure model you choose:

Begin with the most important information, and end with the least important information.

Put the information that all readers need before the information that only a few readers need.

Put basic knowledge before expert knowledge.

Put what’s easy before what’s more difficult. (This is especially important for tutorials and getting started sections, where you should motivate users by giving them a sense of achievement as soon as possible.)

Put things that happen often before things that happen rarely.

Put general information before more specific information.

Put concepts before tasks, and put tasks before reference information.

Put what’s required before what’s optional.

Keep related information as close together as possible.

1-click access to frequently needed information

When possible, provide 1-click access to frequently needed information. Put that information on a high hierarchy level that’s:

important

needed frequently

needed by many readers

Example:

If you expect that many users will use keyboard shortcuts, don’t create a hierarchy like “Appendix > Expert Features > Keyboard Shortcuts” but include the topic “Keyboard Shortcuts” on the top level.

User-based structure

A user-based structure can reflect:

user groups

the expertise of users

use cases or scenarios

stages of use

users’ goals

users’ tasks

Tip:
User-based structures make documents user-friendly because they directly take into account the users’ needs. For this reason, when you can apply a user-based structure, do so. Apply user-based structures in particular to procedures.

Goal-based structure or task-based structure

Often, you can find major goals that comprise a number of tasks. Try to find verbs and then put them into a hierarchical structure.

Example:

creating, changing, and deleting can be grouped into managing

displaying, printing, and exporting can be grouped into outputting

Time-based structure

A time based structure can reflect:

the chronological order of things that are done by the product

the chronological order of processes that happen within the product

the chronological order of steps that users must perform

Tip:
Use a time-based structure in particular for procedures and process descriptions.

Product-based structure

A product-based structure can reflect:

components or modules of a product

operator controls on a device

the menu structure of a program

You can arrange items:

from left to right

from top to bottom

from the outside to the inside

from big to small

Many writers use a product-based structure because the product-based structure is already “given” by the product, so it’s easy to set up without much consideration.

Many readers, however, dislike product-based structures because they don’t reflect what readers are looking for within the documentation.

Tip:
Use a product-based structure for reference information, but don’t use it for concepts, procedures, and examples.

Topical structure

Many subjects lend themselves to natural division. For example, the world can be divided into continents, continents can be divided into countries, countries into districts, and so on.

A topical structure can guide the reader to the correct topic only if the reader already knows and understands the basic principle behind the structure. So topical structures require at least some basic, prior knowledge of the subject.

Within the main chapters of a topical structure, you often need a second criterion to organize the subchapters. In the example of the world, for instance, you could sort the continents, countries, and districts either alphabetically, by size, or by number of inhabitants.

Alphabetical or numerical structure

Alphabetical and numerical structures:

have no logical and no didactical approach whatsoever, so they’re inappropriate for conceptual information

enable readers to find specific information quickly; however, finding information only works if readers already know the subject well enough to be able to look for the right terms

only make sense when there’s a large number of items

Tip:
Use alphabetical or numerical structures for reference sections when there’s no other, more obvious structure. Also use alphabetical or numerical structures when you expect that most users will use a document or document section primarily like an encyclopedia.


Make it goal-centered

Writing: Always start with the main point