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.
One of our project managers saw a review of Altova's XML Spy in Software
Development magazine and is proposing it as the development environment for
a new project. One of its advantages, supposedly, is that it makes it
possible to "automate documentation production using [he thinks] MS Word
macros."
He's asked what I think of it. This PM actually listens to what team
members have to say (wonder of wonders, miracle of miracles!), so I want to
get back to him with "buy it" response or a recommendation for an alternate
product ASAP.
I've never worked with XML. Although I've done a few projects using
Frame+SGML (which I like very much), there is no chance of getting my
(recently purchased for a specific project) vanilla Frame upgraded to
Frame+anything. The XML development environment purchased for this project
will be my only chance to begin doing some XML-based documentation here, so
I don't want them to buy anything truly icky.
I've found a couple of web sites with marketing-type information, and the
online version of the review that inspired the PM, but I'd prefer to hear
some war stories from survivors before I give them my opinion.
* Have any of you used this environment for documentation?
* Can you really use it to generate *documents*, or just DTDs?
* How does it compare to Frame+SGML?
* Can you work with it using variants of the standard DocBook DTD?
* How easy is it to customize an XML Spy DTD?
* Are there any gotchas I should be aware of?
* Are there better products that I can point him at?
If you reply to me offlist, I'll post a summary next week.
Thanks,
/K@ Kat Nagel, kat_nagel -at- rte -dot- com
"Technical fiction: This term refers to user manuals written
according to technical specifications or programmer assurances
about how a system is going to turn out, in the absence of a
working prototype." (M. David Orr, Orr & Associates Corporation)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Develop HTML-Based Help with Macromedia Dreamweaver 4 ($100 STC Discount)
**WEST COAST LOCATIONS** San Jose (Mar 1-2), San Francisco (Apr 16-17) http://www.weisner.com/training/dreamweaver_help.htm or 800-646-9989.
Sponsored by ForeFront, Inc., maker of ForeHelp Help authoring tools
for print, WinHelp, HTML Help, JavaHelp, and cross-platform InterHelp
See www.forehelp.com for more information and free evaluation downloads
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.