"the following" or nothing -- what is IM's preference? (was:"Next" or "th...
HBacheler at aol.com
HBacheler at aol.com
Tue Dec 12 15:20:26 MST 2006
To all.
In my experience, the simpler the better.
I have 'always' put procedures in a table"
Step - Action - result (desired) -(In test procedures) Pass/fail)
The Table has a caption and heading row(s)..
I refer to the heading. by a cross reference.
This makes it easier to get to. And also, I can have an Appendix that is
made up of 'procedures.
Using this technique, it doesn't make any differences about above below. You
don't have to say on 'Previous page/, this page, next page, etc.
As different 'authors, editors, reviewers may have their own 'standards,
there is no mistake when referring to a Paragraph or a cross-reference, etc..Also,
when referring to Figures, Illustrations, Examples, etc, you avoid having to
worry about pages.
When you put a document on the web you are on the 'page', not matter how long
the 'page' is. the 'next page' may not be in the same file you put it in.
Especially if you have a long document and the webmaster, or web folks may
'reorient your 'page''.
As I have no personal knowledge of Information Mapping, Framemaker,
Pagemaker, or some of the more 'advanced' word processors, I tend to 'oversimplify'.
My experience has helped me take this approach. It allows a procedure to be
modified, amplified, and even be used as a TEST procedure if tests are
required. The table compuns can be modified to delete the "Pass'/''Fail' column.
My input to the discussion.
Harry
More information about the TECHWR-L
mailing list