WorldCC Contract Design Pattern Library

CONTRACT DESIGN PATTERN LIBRARY

  • Home
  • About this Library
    • Introduction
    • Why use this Library?
    • A design pattern approach
    • Who is this Library for?
  • How to use this Library
    • Get started
    • Browsing the Library
    • Start from the contract users
    • Using the patterns
  • Explore the Library
  • Pattern families
    • Pattern families in brief
    • Emphasis
    • Explainers
    • Layering
    • Layout
    • Navigation
    • Organizing
    • Reviewing
    • Summarizing
    • Tone of voice
    • Visuals
  • Contribute
  • FAQ
  • About the team
  • About WorldCC Foundation
  • Contact
Back

Skimmable headings

  • Pattern
  • Examples



What is it?

Frequent, highly visible headings that stand out so the reader can move quickly through a document to understand its structure and access its content. There should be one for each clause or paragraph, acting as a layered explanation.

They do not necessarily replace conventional hierarchical headings for chapters or sections (although that is a possibility, too), but work alongside them.

 

What problems does it solve?

Contracts are often very lengthy and visually dense. At a glance, it is hard to get an idea of what they say and to search quickly for specific information – that is, they are not designed to help people to read them strategically.

 

When to use it?

Use skimmable headings for any document you want people to actively engage with and be able to read strategically.

Skimmable headings help people build a context for their reading by skimming through a document before reading more closely. And they help people search for specific answers to their questions.

 

Why use it?

Effective readers engage actively with a document, reading with purpose and monitoring their own understanding as they read. Skimmable headings help them to understand why the document creator has provided the content, and how it is structured. Ideally, skimmable headings should connect with each other to tell a story – and connect with the reader. This is why skimmable headings are often worded as FAQs.

Additionally, skimmable headings are a good discipline for the writer. The process of writing them often reveals flaws in the document structure – for example, clauses which contain two different topics, or clauses which belong somewhere else in the document.

As a note of caution, try not to use technical jargon in headings before it has been explained – you should not have to read a clause to understand its heading.

 

Where to use it?

  • Contract documents
  • Contract appendices
  • Contract guides and playbooks
  • Policies
  • Training materials
  • Requests for proposals



© 2019 Rob Waller.
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

Pattern families
Layering Summarizing Layout Navigation Organizing Reviewing
<

Example 1

Shell Marine Lubricants Terms & Conditions

Shell’s new contracts use skimmable headings in the hand left margin to give the gist of the clause content  – and sometimes spell out the question it answers.

Source: Shell Marine Lubricants Terms & Conditions

© 2018 Royal Dutch Shell plc. Used with permission.
Design: Rob Waller

 

 

 

Share an example!

Have you used skimmable headings in your contracts? You can contribute to the Library by sharing an example.

Submit example

Prominent section start
Split declaration

Loading...
Sign in / Register

© WorldCC Foundation, Stefania Passera & Helena Haapio

Back to worldcc.foundation Sign in / Register Privacy Policy