Revise your document to produce a predictable and logical structure between and within sections.
A predictable and logical structure produces overall document coherence, which allows your audience to read the document efficiently and to use its information
effectively. Consequently, the first review of any technical document should focus on ensuring a
logical and accessible structure.
- If you have not already done so, divide your document into sections and subsections by inserting headings and subheadings into your document.
- Read over the headings and subheadings of your document. (If your document has
a table of contents, review it.)
- Are all the elements of your document type present and in the appropriate order?
If not, are there good reasons for omitting or rearranging some sections?
- Does each section and subsection follow logically from the preceding one?
- Early in the text, is there a clear road map of the entire document? (See Forecasting.) Does the document follow that road
- Review the graphics in the order presented in your
document. Do they present the key information to the reader in a logical
- Read aloud the topic sentence of each paragraph of
your document. Do ideas flow smoothly from paragraph to paragraph? Will the
relationship between one idea and the next be clear to your audience?
Strategies for Revising Organization
- If appropriate, add sections, subsections, and section headings, and subheadings to make your
document conform to its standard type.
- If appropriate, add sections and subsections to improve the logical structure and
coherence of your document.
- If necessary, revise the forecasting statements to
provide the reader with an accurate road map of the ideas that will follow.
- If appropriate, add new graphics and revise and
rearrange old ones to provide the reader with a visual summary of the document's
## Revising Organization ##
[ Home | Table of Contents
| Writing Timeline | Index |
Help | Credits]