Re: Technical Review Guidelines

["McMARTIN, Robert" <rmcmarti -at- BAEA -dot- COM -dot- AU>]

I would add, one thing,

*  When making a correction of a word, or sentence, always draw a line
in the outside margin.

The writer may miss a small change in a line, but a line on the outside
of the page always gets attention.

regards


---------------------------------------------------------------

"Bother" said Pooh, as he strafed the lifeboats.

---------------------------------------------------------------
Robert McMartin
Documentation and Training Development Officer
British Aerospace Australia
677 Victoria Street,
Abbotsford, Victoria,
Australia 3067
61 3 9208 0532
---------------------------------------------------------------
Robert McMartin does not speak on behalf of British Aerospace
Australia and they agree.


> -----Original Message-----
> From: Kathryn Marshall [SMTP:kmarshall -at- MODACAD -dot- COM]
> Sent: Friday, 11 September 1998 10:52
> To:   TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU
> Subject:      Re: Technical Review Guidelines
>
> Thomas, thanks for sharing your technical review sheet. I particularly
> like the checklist - great idea! You might consider condensing the
> paragraphs of instructions because the SME probably won't read it. I
> have distributed cover sheets with big, bold, all caps letters
> requesting reviewers to use a colored pen -- only to receive a draft
> marked up with a pencil. :-|
>
> Our review cover sheet just has a bullet list of "review guidelines."
> For example:
>
> Review Guidelines
> *       Please review this document for technical accuracy only.
> *       Provide corrected/missing information if you know it, or
> suggest
> a source.
> *       If you encounter information that you are not sure is
> accurate,
> please ask someone who knows, or test it yourself. Never just leave a
> question mark in the margin - if you as the technical reviewer don't
> know, no one else will!
> *       Use a  colored pen to mark your comments directly on the
> document. For additional comments, attach a separate sheet and
> reference
> the comments by page number.
>
> I would change the line that says, "Please complete a technical
> review..." to just "Review By."
>
> Just to drill it into their heads, you might want to give the review
> guidelines verbally to the SMEs. It maybe good to sit down with all
> the
> SMEs (call a meeting maybe) and explain the importance of technical
> reviews.
>
> Looks good though - I would like to see your final draft.
>
> Kathy Marshall
> ModaCAD Inc.
> Culver City, CA
>
>

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