Organize Long Documents on Your Webpages
It's a challenge to present long documents clearly, no matter what size screen they are displayed on.
You should:
- Use headings to divide a long document into sections.
- Write to encourage readers to move to the next section. On the web, the next section may well be on another webpage, so readers need encouragement to move on to text they cannot see:
- Signal what's coming next.
- Use transitions to push your reader onward.
- Ideally, keep sections to a maximum of 500 words.
- Link to a table of contents to let readers jump to the part of the document they're interested in reading.
Use Headings and Subheadings
Use short headings to direct readers to content. Use key information (keywords) from the content in your headings and subheadings to allow readers to scan. Keywords not only help readers once they are on a page – they are critical for accurate search engine results.
Use Links and Teaser Text
Usually, link text should have the same wording as the page header of the linked page whether the link appears within the content or as a bullet. For example,
- We partner with the AFN leaders and workforce to ensure they have the resources and information in Performance Management, Recognition, Training and Development, Compensation, and Executive Programs.
- Training and Development
If the user needs more information to help understand why he or she would want to visit that link or use the information found at the link, you may use a "teaser" after the link title. Teasers should be short — never more than 2 lines.
- Passenger's Gateway helps you find which airports have flight delays.
Organize Common Types of Documents
Content Standards include where your content exists. Organize common types of documents to help users navigate more easily. For example, assemble your forms in one location and publications in a separate location. You can always provide a link to a form if you want to reference it within other areas.