Single-sourcing tool

elizabeth j allen eja at samurai.com
Fri Jan 5 08:14:43 MST 2007


Hi Robert,

I'll do my best to explain, but I'm one of the LaTeX newbies, so try and
cut me some slack please! (Not to mention that I can't divulge trade
secrets, so all you get is generic info--sorry!)

We are writing documentation for related chips--much of the information is
the same for all of the products in the family, but it also overlaps in
weird ways.

\ifthenelse(A + (\not B + \not C))(true_statement)(false_statement)
is what we use in LaTeX to help sort out the conditions

For example, Chip A is exactly the same as chip B, except that chip B has
certain functions removed. Chip C is also based on Chip A, but has some
things removed and others added. There are also chips D, E, and F in the
pipeline, all based on chip A, but their functionality has not yet been
completely defined and tends to change from time to time. *But* because
these chips are all based on A, the A condition = true for all of them.

That's because we also have chip families I, II, III; and a, b, c; and i,
ii, iii. And they all have documentation, much of which is common to all
the families.

Different customers get different chips, thus different capabilities,
along with different price points. You can see why we can't let info slip
through the cracks.

This is why Framemaker, with its simple OR conditional, can't do what we
need it to do. And why I need help finding a tool that can.

Thanks!

Elizabeth
--
Elizabeth J. Allen
Technical Writer
"Make everything as simple as possible, but not simpler." -- Albert Einstein


Robert_Johnson at percussion.com said:
> Elizabeth,
>
> Why are the conditionals used, and how?  I have an idea in mind (actually
> a set of ideas), but I'm not sure how practical it is until I understand
> what's going on with conditionals.
>
> Bob Johnson
> Principal Writer
> Percussion Software
> Woburn, MA





More information about the TECHWR-L mailing list