TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
RE: Two questions for single-sourcing practitioners
Subject:RE: Two questions for single-sourcing practitioners From:"David Knopf" <david -at- knopf -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Sat, 16 Mar 2002 12:48:45 -0800
Dick Margulis wrote:
| Now the next RFP comes along, some weeks or months later. I go to the
| database and somehow find the chunks of text I need to respond to the
| questions (or, ideally, someone else does--hey, it could happen). But
at
| this point the sixty-four dollar question--the one I posed initially,
by
| the way--is this: How do I _know_ that the answer I'm retrieving is
still
| accurate? I know what date it was written and by whom. I can tie it to
| some prior version of the software. But there are a lot of features
that
| are stable and are not going to change anytime soon. So the fact that
a
| response is old doesn't mean it's wrong. HOW CAN I TELL?
You can't. I don't think there is a content management, knowledge
management, or single source system that will analyze the content for
you and let you know if it's accurate and up-to-date. (Hey, if we could
come up with a system like these, we could probably retire very early!)
| >> Again, this is looking at the situation from the wrong end of the
| horse. However, if the system were linked with the Help development
| system, then every time a Help topic changed, that could be reflected
in
| the SSDB, right?
| >
| >errrr....I'm not sure. The only way a Help topic can change is
through
| the SSDB...
|
| Yes but ...
|
| In another current thread, John Garison is extolling the wonders of
using
| Dreamweaver as the Help authoring system. That system ain't broke, so
I
| have no inclination to fix it. Therefore, if I'm going to rely on Help
| topics for content, I have to link (automatically and transparently)
to
| John's system; I'm not going to ask John to abandon it in favor of a
joint
| single-sourcing effort.
There shouldn't be a need for John to drop Dreamweaver or substantially
modify his workflow. Dreamweaver (like any similar tool) just works with
objects (HTML files, CSS files, graphics files, etc.). Objects can be
stored and managed. (But you still need the human element to determine
if the content of the objects is accurate and up-to-date.)
| Now you understand the problem. People are living in their own little
| worlds and do not really consider who needs to be notified outside
their
| own departmental hierarchies (I don't think this is unusual, by the
way).
| Proactive notification would require that someone think of the needs
of
| others--which requires more maturity than many people can muster.
I don't think this situation is terribly unusual, either, though I have
worked with a number of organizations that didn't manifest these
particular issues. Some people try to address these issues by imposing
process(es), but in my experience you can't successfully impose
process(es) on people who aren't buying.
| Not sure I'm following what you did/what you tested. What I'm looking
for
| is differential output, so that a register mark comes out as a
superscript
| in Word but not a superscript in HTML and "(R)" in plain text. Or a
"dash"
| (grammatical mark) comes out as space-en dash-space in Word but
ampersand-
| hash-151-semicolon (without surrounding spaces) in HTML and
hyphen-hyphen
| in plain text. As I said, this gets subtle.
This, I think, is the only part of your inquiry that touches on "single
sourcing" as opposed to content or knowledge management. I don't know
AIT well, but this kind of differential output is no problem using
traditional single sourcing tools like FrameMaker/WebWorks or MIF2GO and
the higher-end solutions. Each character, actually, can produce
different output in different media.
WebWorks and RoboHelp Certified - RoboHelp MVP
Member, RoboHelp Advisory Board & JavaHelp 2.0 Expert Group
Moderator, HATT & wwp-users
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check it out! Get some cool freebies when you buy RoboHelp! You'll receive
SnagIt screen capture software and a 10% discount voucher for RoboHelp
Consulting. This special offers expires March 29, 2002.
www.ehelp.com/techwr
---
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 http://www.raycomm.com/techwhirl/ for more resources and info.