Example material
See what a clearer structure contains.
These extracts explain the kinds of structure we can work on. They are teaching material for this site, rather than records of customer projects.
Document preparation guide
Before you share a file
Choose the version that contains the information you want readers to use. Keep related sections together so that the sequence makes sense without extra explanation.
File names
A useful file name tells you what the document contains. Include the subject or purpose so that it remains recognisable outside its original folder.
Read the source-file checklist Source-file checklist
- Identify the version to be reviewed.
- Keep any available editable source with the corresponding document.
- Note any images or tables that need background information.
Heading levels
The guide, section and subsection each have a distinct place.
Descriptive links
The link names the checklist it opens.
Reading sequence
The preparation notes lead naturally into the checklist.
Inside a report
Give the visual its context.
A description and table headers make the relationships in this extract explicit.
Working with document illustrations
The stages below organise the material from its outline to its review notes.
Outline Content Review
Image description: A document passes from an outline of its main headings, through text and illustrations, to a review of change notes.
Sections in this extract| Section | Content |
|---|
| Outline | Main headings |
|---|
| Content | Text and illustrations |
|---|
| Review | Change notes |
|---|
Across several files
File structure overview
These sample file names show how a set can be organised by purpose. They illustrate Document Collection, without fixing the number of files in your work.
Purpose
Introduction
Heading: Purpose of the set
Establish what the documents cover and how their subjects fit together.
Notes
Working notes
Heading: Preparing the material
Keep practical instructions beneath a heading that describes the task.
Sources
Reference material
Heading: Supporting information
Give background sources a clear place separate from the main instructions.
A change report extract
What changed, and why.
The report links an adjustment to a location and a reason. It records work rather than certifying compliance.
Location Change Reason
Location
Preparation guide: File names
Change
Nest the subsection beneath Before you share a file.
Reason
Make the relationship between the section and its supporting detail explicit.
Location
Preparation guide: checklist link
Change
Use “Read the source-file checklist” as the link label.
Reason
Explain the destination without relying on the surrounding sentence.
Location
Illustrations extract: section table
Change
Identify the column headings and the section name in each row.
Reason
Connect each content entry with its section and column context.