Single-sourcing tool

Subject: Single-sourcing tool
From: "elizabeth j allen" <eja -at- samurai -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 5 Jan 2007 09:34:42 -0500 (EST)

Oh mighty techwhirlers, hear my plea!

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-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Follow-Ups:

Previous by Author: Re: How D'ya Find Out ...
Next by Author: RE: Single-sourcing tool
Previous by Thread: Re: Readability question?
Next by Thread: RE: Single-sourcing tool


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


Sponsored Ads