Post History
In writing procedural documentation, I have the choice of writing the complete step-by-step instructions with references to an appendix of illustrations, For instance: 1. Do task 1 (see Fig. 1) ...
#3: Attribution notice added
by
System
·
2019-12-08T04:00:03Z (almost 5 years ago)
Source: https://writers.stackexchange.com/q/16015 License name: CC BY-SA 3.0 License URL: https://creativecommons.org/licenses/by-sa/3.0/
#2: Initial revision
by
dwwilson66
·
2019-12-08T04:00:03Z (almost 5 years ago)
In writing procedural documentation, I have the choice of writing the complete step-by-step instructions with references to an appendix of illustrations,
For instance:
1. Do task 1 (see Fig. 1)
2. Do task 2 (see Fig. 2)
Illustrations
-------------
+-------+
| Fig 1 |
+-------+
+-------+
| Fig 2 |
+-------+
or to accompany each step with an illustration, almost as if the steps were the captions to the illustrations,
For instance:
+-------+
| Fig 1 |
+-------+
1. Do Task 1.
+-------+
| Fig 2 |
+-------+
2. Do Task 2.
Is there any research to show which method is more effective for the person attempting to learn the material? What are some of the considerations I need to make in choosing one method over the other?
If it makes any difference, each document is 10-15 pages long, about 25% of which is text and 75% is illustration.
#1: Imported from external source
by
System
·
2015-01-26T21:11:29Z (almost 10 years ago)
Original score: 3