RE: Of myth and reality

Subject: RE: Of myth and reality
From: "David Knopf" <david -at- knopf -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 22 Jul 2002 14:17:52 -0700

SteveFJong -at- aol -dot- com wrote:

| When someone says there's a 90% overlap without specifying
| units, I grow skeptical. It's easy to take up 100KB with a
| single screen shot, but 100KB of text is more labor-intensive.
| Is the 90% overlap one of words, or simply bytes?

Oh, I see. I meant that 80-90% overlap in the text content is not
unusual in technical documents. Sometimes it's less, occasionally more.
These metrics only tell part of the story, though, so one should not
give them undue weight. For example, if there are two 500-page
documents, one of which will be delivered both in print and online, the
other of which will be delivered in print only, one could say there is
only 50% overlap. That would be misleading, though, because the omission
of an entire document from one or the other output medium usually does
not create additional labor.

| Are you saying you do not recognize the similarity
| between compiling source code and single-sourcing information
| using XML? (If your "solution" doesn't
| involve XML, I apologize; you haven't been specific.)

I am saying that the method of producing binary executables for the
Macintosh platform has little or nothing to do with the methods for
single sourcing content in technical documents.

XML is only one of the technologies you can use for single sourcing.
Single sourcing is not by definition based on XML. I haven't been
specific about a solution because there is more than one solution. I am
trying to address the merits of an approach (single sourcing) and not a
specific product.

| >> Simply disparaging the arguments of others without offering
| >> substantive replies does not, it seems to me, advance your case.
| I agree. Maybe a sample page in MIF would help?

I'm confused here. What would a 1-page MIF file demonstrate?


David Knopf / Knopf Online / San Francisco, CA
mailto:david -at- knopf -dot- com /

Consulting & Training on FrameMaker & WebWorks Publisher
Consulting & Training on RoboHelp
WebWorks Publisher Certified
Member, JavaHelp 2.0 Expert Group
Moderator, HATT & wwp-users

Buy RoboHelp Deluxe starting at only $798: you'll get RoboDemo, the hot new
software demonstration tool that's taking the Help authoring world by storm,
together with RoboHelp Office. Learn more at

Your monthly sponsorship message here reaches more than
5000 technical writers, providing 2,500,000+ monthly impressions.
Contact Eric (ejray -at- raycomm -dot- com) for details and availability.

You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

RE: Of myth and reality: From: SteveFJong

Previous by Author: RE: Of myth and reality
Next by Author: RE: Of myth and reality
Previous by Thread: RE: Of myth and reality
Next by Thread: RE: Of myth and reality

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

Sponsored Ads