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.
If you worked in a small department (2 tech writers) within a larger
company (16,000+ employees worldwide), and you were given the task of
recommending a tool to use, what would you recommend? But wait, there's
more! Here's the info you have to base your decision on:
? The current tool for technical manuals is LaTeX
? The group of two may grow to a group of 5 before the end of the year
? The growth is driven by massive new products being developed
? The level of documentation complexity is increasing exponentially
? Long learning curves for tools are *not* a good thing (see "LaTeX")
? Single-sourcing is *required*
? LaTeX is used because it supports complicated conditionals like:
\ifthenelse(A + (\not B + \not C))(true_statement)(false_statement)
? The new tools need to support complicated conditionals
? Your manager trusts your recommendation and needs it today
? Whatever you recommend will be the tool you and your coworkers use
for these new massive doc projects. They'll blame you if it sucks.
I bow myself before the collective wisdom of the great techwhirlers!
Elizabeth "Is that complicated enough for you?" Allen :)
--
Elizabeth J. Allen
Technical Writer
"Make everything as simple as possible, but not simpler." -- Albert Einstein
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today! http://www.webworks.com/techwr-l
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output. http://www.DocToHelp.com/TechwrlList
---
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-