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: The magic tool that everyone can use without stepping on toes
Subject:RE: The magic tool that everyone can use without stepping on toes From:"McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com> To:Gene Kim-Eng <techwr -at- genek -dot- com> Date:Wed, 13 Jun 2012 13:20:03 -0400
OK, I'm intrigued (enough, even to overlook that you said DITA :) ).
Was it an off-the-shelf system that glued it all together? Or a roll-your-own effort?
From: Gene Kim-Eng [mailto:techwr -at- genek -dot- com]
Sent: June-13-12 12:19 PM
To: McLauchlan, Kevin
Cc: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: The magic tool that everyone can use without stepping on toes
It would be structured, topic-based documents with the topics stored in or linked to a searchable knowledge database. XML and DITA are the currently preferred format flavors, but there's no reason why it couldn't be something else. I've done it in the past with alternate FM or Word sections in FM books or Word master documents. What's important is the ability to swap out standard topics for customized versions and to sort all the stored custom versions by variation so you don't end up with multiple "custom" versions that are identical except for their file names.
Gene Kim-Eng
On Wed, Jun 13, 2012 at 9:04 AM, McLauchlan, Kevin <Kevin -dot- McLauchlan -at- safenet-inc -dot- com<mailto:Kevin -dot- McLauchlan -at- safenet-inc -dot- com>> wrote:
.What would be your response to him, in 2012? Don't say DITA.
The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help. Choose your authoring formats and get any output you may need.
Try Doc-To-Help, now with MS SharePoint integration, free for 30-days.