Re: Getting more than nits from reviews? (take II)

["Susan Hogarth" <hogarth -at- gmail -dot- com>]

On 5/23/07, Geoff Hart <ghart -at- videotron -dot- ca> wrote:
> ...
> Seriously? Yes, you should copyedit. Never submit anything other than
> your best work. Reviewers won't respect you if you send them junk,
> and if you make their life harder than necessary, you'll get lousy
> reviews. Think of this as a law of nature, like the fact that gravity
> points downward most days <g>, and you'll find it easier to accept.
>
> If you've done your homework (i.e., you have interviewed the SMEs to
> learn the details of the process you're documenting and have
> carefully checked these details against the actual interface), they
> shouldn't be rewriting _anything_. The ideal review comment is
> "Perfect... no changes!" In the real world, that never happens, but
> that's the direction you should be aiming.

OK, I am properly raked-over-the-coals. However, I haven't presented
it exactly right. These are more team members than SMEs - THEY have
done the writing. They send it to me. I knit the pieces together
loosely. My boss says "They need more details" (he always says that)
and I ask them to provide more details. They may be doing an entire
re-write at this stage. Still copyedit?

I SWEAR I am not whining!!! ;-)

-- 
Susan Hogarth
http://www.colliething.com
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create HTML or Microsoft Word content and convert to Help file formats or 
printed documentation. Features include support for Windows Vista & 2007 
Microsoft Office, team authoring, plus more.
http://www.DocToHelp.com/TechwrlList

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual: http://www.helpandmanual.com

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
http://www.techwr-l.com/ for more resources and info.