RE: Information Mapping Formatting Template

Subject: RE: Information Mapping Formatting Template
From: "Hedley Finger (EPA)" <Hedley -dot- Finger -at- ericsson -dot- com -dot- au>
To: "'mconte -at- bellsouthwd -dot- com'" <mconte -at- bellsouthwd -dot- com>, framers -at- FrameUsers -dot- com, "'Free-Framers Self-Help'" <framers -at- omsys -dot- com>
Date: Tue, 8 Feb 2000 13:35:40 +1100


Mario:

Why not roll your own? And, whatever you do, get rid of those dopey tables
for procedures because they break up the natural left-right eye-scanning for
reading prose. Instead they turn eye-scanning from a flat line to a
sawtooth wave as the reader reads down to the bottom of a table cell then up
to the top of the next cell. Ditch the 'Result' and 'Note' labels and just
add outcome descriptions and further explanations after each action step as
straight prose. (But mentally note whether you adding results or whatever,
and use the IM checklists to ensure blocks contain a single information
type, etc.)

Keep tables for the information type they best represent -- classifications.
Information [m]Mapping (oooops! nearly copped a $lebenty billion trademark
infringement suit there!) is really no more than a codification of technical
writing best practice since documentation began. But you can't patent that
so the IM people trick it up with all sorts of layout frippery so that they
can claim some kind of uniqueness.

[FrameMaker 5.5.6, Acrobat 3.02, Windows 98, HP OmniBook 2100]

Regards,
Hedley Finger Technical Writer


Subscribe to the alternative framers:
<mailto:majordomo -at- omsys -dot- com?Subject=Subscribe%20to%20framers>; message must
consist of only (no signature) --
subscribe framers your -at- preferred -dot- email -dot- address
help
end

Ericsson Australia Pty Ltd
Tel. +61 3 9301 6214 Cell. +61 412 461 558 Fax. +61 3 9301 6199
Email. hedley -dot- finger -at- ericsson -dot- com -dot- au

Hand Holding Projects Pty Ltd
Tel. +61 3 9809 1229 Cell. +61 412 461 558 Fax. +61 3 9809 1326
Email. hfinger -at- handholding -dot- com -dot- au

>>>>>
> I am writing in reference to using FrameMaker Software in conjunction
>
> with the Information Mapping Formatting Solution template.
>
> Information Mapping, Inc. distributes a formatting solution template
> with their Structuring User Documentation manual, which can be
> obtained in their training seminars. The formatting template is
> available in many formats, including FrameMaker. ... .
>
> QUESTION: Has anyone ever encountered any problems when using the
> Information Mapping Formatting Solutions template in FrameMaker?
<<<<<
>




Previous by Author: Telecom equipment doc standards?
Next by Author: OT: Hyperlinks launch browser but no page appears (BILL BASHERS Q UEUE HERE)
Previous by Thread: Re[2]: Generally, what do you think of generally?
Next by Thread: Generally, "generally" is OK


What this post helpful? Share it with friends and colleagues:


Sponsored Ads