Re: Thoughts on working WITH developers...

Subject: Re: Thoughts on working WITH developers...
From: Eric Ray <ejray -at- RAYCOMM -dot- COM>
Date: Fri, 26 Mar 1999 09:43:58 -0700

>First thing he did was modify parts of the interface, so that the delay
>was no more his responsibility, but mine.
>Happily, this is not the rule, but knowing that there are people who
>have this behaviour helps.

If I'm understanding this correctly, your developer modified
the interface at the last minute, then (the unnamed someone
referred to above) assigned responsibility for missed deadlines
to you? Really?

You desperately needed management support, a clear
documentation development process, or both. That simply
shouldn't happen.

For those who are or might be in this situation...
When you agree to deadlines for documentation
deliverables, you need to specify the schedule with
respect to specific milestones in the product development
schedule. That is, something like:

Documentation draft due at functionality freeze+2 weeks
Final draft hard copy manuals at GUI freeze+2 weeks
actual real books at GUI freeze+6 weeks or at
review return date + 4 weeks
online help at GUI freeze or functionality freeze (whichever
is later) + 3 weeks
Obviously, insert your own lag time, based on changes,
size, scope, printer schedules, etc.

If your management etc. tells you that you have to deliver
documentation products on or before the day that the code freezes
or product ships, you need to have them sign off (literally
or figuratively) on what WILL NOT be done. That is,
"boss, I'll be happy to deliver the docs on the day that the
code freezes...would you rather have inaccurate screenshots,
inaccurate processes and descriptions, or what? I'll fill in
the rest in photocopied release notes as soon as possible."

Eric J. Ray RayComm, Inc. ejray -at- raycomm -dot- com

*Award-winning author of several popular computer books
*Syndicated columnist: Rays on Computing
*Technology Department Editor, _Technical Communication_

From ??? -at- ??? Sun Jan 00 00:00:00 0000=

Previous by Author: Re: Thoughts on working WITH developers...
Next by Author: Re: FWD: formerly naive now burned tw needs advice
Previous by Thread: Re: Thoughts on working WITH developers...
Next by Thread: Re: Thoughts on working WITH developers...

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

Sponsored Ads