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.
The magic tool that everyone can use without stepping on toes
Subject:The magic tool that everyone can use without stepping on toes From:"McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com> To:"techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 13 Jun 2012 12:04:48 -0400
I found the following, from somebody in our company in 2006:
"What I am really looking for is a way to create customized versions of the
documentation that the Tech Pubs and Marketing groups already create/maintain
while being able to add, delete, modify, and augment said content. This will allow us
to deliver custom documentation for professional services engagements that target
the organization's specific environment and needs. This would make keeping up-to-date
with documentation updates and changes much easier on my end. One of my requirements
is to provide this documentation in both a printed and an indexed, searchable electronic
version. Ideally, it would be possible for the customer to add their own work product to
this electronic version once it is delivered so that they could store all information related
to their implementation in one place. "
I replied something like:
"You want TechPubs* and Marketing to drop all our current tools and start
producing all documents in a common Wiki?"
I think the guy left the company soon after, so I never followed up with him,
nor he with me.
What would be your response to him, in 2012? Don't say DITA.
(*TechPubs was, at best, a classification, not a department. Then, as now, there was no single ownership or leadership.
I think Marketing was ... if not a group... at least reporting to a single Veep somewhere. So, images of herding cats while pushing string should come to mind.)
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.