RE: What Program Do You Use for Software Documentation?

Subject: RE: What Program Do You Use for Software Documentation?
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "Leonard C. Porrello" <Leonard -dot- Porrello -at- SoleraTec -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 22 Oct 2008 16:58:22 -0600

Leonard C. Porrello wrote:

> A hammer is a fine tool for smashing your thumb, but it stinks for
> authoring documents that call for sophisticated single sourcing and
> reuse. Similarly, Word is a great tool for some ends. So is
FrameMaker.
> However, neither Word nor FrameMaker facilitate sophisticated single
> sourcing or reuse ("snippets"). If you don't need those things,
> fantastic. Word or FrameMaker may be just the ticket; if you do,
you'll
> want to avoid both Word and FrameMaker and look to H&M, Flare,
RoboHelp
> or AuthorIt.

Nonsense. Countless tech writers have been single-sourcing manuals and
online help with a hammer -- I mean with FrameMaker -- for years. There
are several competing products available that facilitate doing so:
ePublisher Pro, Mif2Go, Adobe Technical Publications Suite (with
integrated FrameMaker and RoboHelp versions). All enable as much
"sophistication" (if not more) than the tools you mentioned.

It's not clear what you mean by "reuse ('snippets')," but if you're
thinking of a database-driven solution, I understand from those who've
done it (I haven't) that implementing it with FrameMaker is far easier
than the alternatives.

I used RoboHelp heavily in the past, but that was for a client who
wanted online help only. At that time (the eHelp days), you couldn't pay
me enough to use RH for print/PDF delivery. Maybe that's changed, but
I'll bet dollars to donuts that the FM+RH solution offered in the Adobe
TPS is far more capable and less aggravating.

Someone else will have to stick up for Word. I could, but my heart
wouldn't be in it. ;-)

Richard


Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
303-223-5111
------
rgcombs AT gmailDOTcom
303-777-0436
------






^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -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%40web.techwr-l.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/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


Follow-Ups:

References:
What Program Do You Use for Software Documentation?: From: Paul Weir
Re: What Program Do You Use for Software Documentation?: From: quills
RE: What Program Do You Use for Software Documentation?: From: Leonard C. Porrello

Previous by Author: RE: [TOOLS] DIMM insertion-key gap
Next by Author: RE: Documenting hardware interfaces
Previous by Thread: RE: What Program Do You Use for Software Documentation?
Next by Thread: RE: What Program Do You Use for Software Documentation?


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


Sponsored Ads