RE: Developments in the review cycle

Subject: RE: Developments in the review cycle
From: "Steve Hudson" <sh1448291904 -at- gmail -dot- com>
To: "'Erika Yanovich'" <ERIKA_y -at- rad -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 6 Apr 2016 23:45:58 +0700

In 'the old model', did people really send the whole manual out for review
to a number of SMEs, or did they send relevant chunks of it out? Personally,
MOST of the time I used chunks, but infrequently it appears that the one SME
is responsible for the entire content. The question then becomes, what is
the relevant chunk size, and I cannot recall a single case where most topics
had a different SME. So, 'manual' is too large a chunk, and 'topic' is too
small. Ye Olde Chapters were reasonably close to the right size for most
properly structured documents.

Regardless of chunk size, media or even if it is documentation, code or
physical product, there is a 'draft/prototype' <==> a 'review/test' cycle
iteratively performed until the measurement of the product is within
tolerance of the specification. I fail to see how this will ever change,
merely that the number of iterations has been drastically reduced through
decades of study of the best practices and the development of methodologies
specifically to address this reduction in cycles, and thus lead time / cost.
IME for documentation the first review can sometimes lead to a substantive
edit, which then requires a second review for signoff which may require a
minor edit requiring no follow-up review. Thus the "Outline (very useful for
managers to then use as a basis for projecting completion dates) -First
draft-Second-draft- Camera ready (produced)" is most certainly still with
us.

-----Original Message-----
From: techwr-l-bounces+sh1448291904=gmail -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+sh1448291904=gmail -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Erika Yanovich
Sent: Wednesday, 6 April 2016 12:08
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Developments in the review cycle

In the "good old days", tech writers followed the Outline-First
draft-Second-draft-Camera ready model. We would submit an entire publication
for review (perhaps with some minor TBDs inside) and the world was a simpler
place.

What I see nowadays is more dynamic: partial drafts (or bunch of topics)
sent to different reviewers at different times. The stages are blurred and
the follow-up more complicated.

I know some of you don't believe in complete publications anymore, just in
separate topics that get compiled daily (or whenever) into a larger entity,
but publications are still alive and kicking out there.

So my questions are:
1. Do you also see this transformation?
2. If yes, how do you cope with it?
3. Should we manage each chunk separately according to the old model (sounds
a bit crazy) or replace the old model with a new one?

Erika
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and
content development | http://techwhirl.com

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

You are currently subscribed to TECHWR-L as sh1448291904 -at- gmail -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online
magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public
email archives @ http://techwr-l.com/archives


---
This email has been checked for viruses by Avast antivirus software.
https://www.avast.com/antivirus

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.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-leave -at- lists -dot- techwr-l -dot- com


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

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
Developments in the review cycle: From: Erika Yanovich

Previous by Author: RE: Developments in the review cycle
Next by Author: RE: Friday Light: Don't Let Engineers Write Docs
Previous by Thread: Re: Developments in the review cycle
Next by Thread: Re: Developments in the review cycle


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

Sponsored Ads


Sponsored Ads