RE: What are "advanced" API topics?

Subject: RE: What are "advanced" API topics?
From: "Lydia Wong" <lydiaw -at- fpoint -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 30 May 2001 11:12:30 -0400

Glenn Maxey wrote:

> I realize that Walden, Lydia, et al put little stock in tools. Rightly so.
> The tech writer is still going to have to hit the trenches, still
> gonna have
> to understand the big picture, still gonna have to figure it out.

Well, just to clarify, I wouldn't say I "put little stock in tools." I've
used a few auto-documentation tools to generate material for checking our
docs, just as Glenn wrote. They can be very useful for that. I can also see
how an auto-documentation tool that generates documentation would be
extremely useful. I haven't seen one yet that fit our particular needs where
I work, though.

Actually, I'm optimistic that by taking advantage of XML tags and XML
capabilities, we will someday soon see (or create??) a tool that provides
the flexibility we need. The provision of XML-like tags in C# is a preview
of what might be possible, I believe.

I'd be very interested in tools as a topic. If I'd been at STC this year,
I'd certainly have attended Manuel Gordon's and Greg Rakauskas's
presentation. It sounded excellent (fortunately, Greg works here in the RTP
area, and gave a preview of his part of the talk to our local STC chapter).

I think a kind of "advanced API writers" mini-workshop or track where we can
mingle, discuss tools, have presentations such as Greg's and Manuel's, in
addition to one on creating examples (and the facets of that people have
discussed in the other posts), would be first rate.

I'm glad so many people have had excellent ideas on this! I hope something
comes to pass for next year's STC conference. I would definitely try to

Lydia : )
Lydia Wong
Technical Writer
FarPoint Technologies, Inc.


*** Deva(tm) Tools for Dreamweaver and Deva(tm) Search ***
Build Contents, Indexes, and Search for Web Sites and Help Systems
Available now at or info -at- devahelp -dot- com

Sponsored by Information Mapping, Inc., a professional services firm
specializing in Knowledge Management and e-content solutions. See or 800-463-6627 for more about our solutions.

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

RE: What are "advanced" API topics?: From: Glenn Maxey

Previous by Author: RE: What are "advanced" API topics?
Next by Author: scrolling trackballs and Frame, MSWord
Previous by Thread: RE: What are "advanced" API topics?
Next by Thread: RE: What are "advanced" API topics? + XML - where's the beef?

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

Sponsored Ads