Re: Rant: Giving up on XML

Subject: Re: Rant: Giving up on XML
From: Steve Read <steve -at- readonly -dot- com>
To: Diane Brennan <dalaine00 -at- yahoo -dot- com>
Date: Wed, 14 Mar 2007 18:37:48 -0600

Diane Brennan wrote:
> I agree with Janice that this decision depends on the type of writing environment you are in. It may not make sense to convert documentation to a new tool if you are part of a small writing group in a small company. But for large companies with many writing groups that make monthly deliveries of new or updated docs to the Web (as Web pages, not PDFs), XML makes more sense.
> But XML is not difficult to learn. Two contracts ago I wrote documents in raw XML in an IDE and it was just as fast as writing in any other authoring environment.
Yes. I am a one-person writing department in a small company, and the
first time I used tag languages, the names ended in "roff." Because of
my past experiences at big companies using "pure" XML editors such as
XMetal and Epic, I was predisposed to using such a tool. But the
overhead and upfront costs to get going are huge, and I had neither the
time nor the money to invest. I have deadlines of last month for
everything I'm doing.

I chose to go with structured Framemaker and WebWorks EPublisher. I can
be productive right out of the box, and I can create tightly-structured
docs (a big component of my workload is API docs, which lend themselves
to tight structure). I figure that, should the tools mature to the point
where I don't have to write macros to print or to create HTML, I'll have
a set of structured docs that will be relatively painless to migrate to
a new authoring environment. Or not. We'll see.

Steve Read


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.

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual:

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

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 for more resources and info.

Re: Rant: Giving up on XML: From: Diane Brennan

Previous by Author: RE: Steve Cavanaugh's STE post
Next by Author: RE: Old PC Technology (too long, sorry)
Previous by Thread: Re: Rant: Giving up on XML
Next by Thread: Re: Rant: Giving up on XML

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

Sponsored Ads