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.
>UML with Rational Rose was
>supposed to be a great aid to development, and it was -- for the
>developers. On the documentation side, it would have been very helpful
>to the writers, except that the developers were not putting IN the
>comments we needed so we still had to interview them anyway. Apart from
>that, it was indeed "fun".
About five years ago, when we were just getting the company off the ground, our new analyst/architect-type person, who shared a large office with a senior developer and me, persuaded the development VP to purchase the whole rational suite. One day she ran across some glitch in one of the products, having to do with assembling a Word document as output from the database. So she went to Rational's site to research the issue, and she found the tech note that was supposed to help her resolve the problem.
Lemme tell ya, the three of us together, with a mean IQ of maybe 150, could not make sense of that tech note. Maybe Rational's tech writing staff were all out at an STC convention or something when the problem first arose and some developer wrote that note, and maybe the rest of their documentation is crystal clear; but let's just say that confidence was not inspired.
I hope the training John signed up for is better written and edited.
ANNOUNCING ROBOHELP STUDIO
Create professional Help systems that feature interactive tutorials and
demos with all new RoboHelp Studio. More at http://www.ehelp.com/techwr-l2
Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See www.mercer.edu/mstco or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-
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.