RE: Technical Documentation solutions?

Subject: RE: Technical Documentation solutions?
From: "Sean Brierley" <sbri -at- haestad -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 27 Aug 2002 14:20:08 -0400

Although, if all that is being updated is a snippet of code, that gets
referenced by a doc (like a text inset in FrameMaker), and the
surrounding "higher-level" text never gets changed . . . it's just that
this sorta think seems ripe for a database rendered by XML and feels
much more than a six-month project for a contractor . . ..

Anybody do anything like this with code?



Sean Brierley
Software Documentation Specialist
Haestad Methods
203-805-0572 (voice)
203-597-1488 (fax)

-----Original Message-----
From: Sean Brierley

That's fine. Am having some honest disagreement with you, is all. It's
an interesting thread and am looking to learn a few things--maybe change
my opinion some.

This last reply seems different than some of the other discussion. I
look forward to seeing what other discussion happens and how your work
turns out. Yes, I'm skeptical (and opinionated) but, no offense

The nitty-gritty bottom line is, for me, your plan to implement this
without including technical writers (who will use the content you
propose to create), without adding any burden to the engineers,
analysts, and team leaders, in a way that the content automatically
updates itself all the way up the document chain, in a way that is self
sufficient, and in a way that has you leaving in 6 months, seems
fantastic. Certainly, your further plan to have this used as a company
model across UPS is outside the scope of your time . . ..


Check out the new release of RoboDemo, our easy-to-use tutorial software.
Plus, buy RoboHelp Office in August and save $100 with our mail-in rebate.
Get details and download free trial versions at

TECHWR-L is supported by ads and sponsorships...and donations.
You can help maintain the TECHWR-L community with donations

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.

Previous by Author: RE: Technical Documentation solutions?
Next by Author: RE: Technical Documentation solutions?
Previous by Thread: RE: Technical Documentation solutions?
Next by Thread: RE: Technical Documentation solutions?

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

Sponsored Ads

Sponsored Ads