RE: Expectations too high?

Subject: RE: Expectations too high?
From: Lucy Connor <lconnor -at- asmr -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 21 Sep 2004 09:00:36 -0400


I've taken to scheduling a weekly meeting with each developer. We sit down
for 15-30 minutes, and I ask them questions about their areas of expertise.
At first they didn't want to commit to these meetings, but I got the project
manager in my corner, and now no one seems to mind. My trick is to keep the
meetings short and bring gifts of coffee, soda, cookies, etc.

Much luck, I know how it feels.

-----Original Message-----
Subject: Expectations too high?


Im not entirely new to technical writing but landed in a rather unique
situation, Im supposed to write all the help files, user manuals, training
docs for 5 x custom developed software programs, but Im sitting in a office
on the other side of the building. I don't get included in any of the
project meetings, and have no idea when the latest releases takes place or
what is in them.
The developers think I have to write
the manuals out of my own knowledge, on my own steam, but I don't know the
products. Anyone else facing the same situation?

So what I did (my first project was to do a technical installation manual)
was to gather info that was done previously by the developers, and combine
these. I know what a manual should look like, so I formated the
information. Then I went around gathering more info, and presented it to
the 7 x developers on that specific project. The tore the whole doc to
pieces, and one of them then sat and documented the correct info.
Well, all I can say, is I got a document out of them in the end.

What is the correct way this should work, how do you guys get the product
information?

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ROBOHELP X5: Featuring Word 2003 support, Content Management, Multi-Author
support, PDF and XML support and much more!
TRY IT TODAY at http://www.macromedia.com/go/techwrl

WEBWORKS FINALDRAFT: New! Document review system for Word and FrameMaker
authors. Automatic browser-based drafts with unlimited reviewers. Full
online discussions -- no Web server needed! http://www.webworks.com/techwr-l

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Follow-Ups:

Previous by Author: ADMIN: Code Comments as Documentation
Next by Author: RE: "This page intentionally left blank" leaves me blank..
Previous by Thread: Expectations too high?
Next by Thread: Re: Expectations too high?


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


Sponsored Ads