Re: Developments in the review cycle

Subject: Re: Developments in the review cycle
From: Gene Kim-Eng <techwr -at- genek -dot- com>
To: Keith Hood <bus -dot- write -at- gmail -dot- com>, mbaker -at- analecta -dot- com
Date: Mon, 11 Apr 2016 18:20:55 -0700

If you're documenting hardware, there's usually a lot more that dictates the content than some developer or product manager's predictions of how the end product will be used. Failure mode analysis, safety reviews, reliability testing, etc., all produce content that needs to be documented somewhere, though not necessarily in what ships with the product. And once the development gets beyond a certain point, additional changes mean that all that analysis, review and testing needs to be thrown out and done all over again. And then there's all the stuff in the production pipeline that would have to be reworked or scrapped.

So yes, it certainly is possible to reach a point where "no more development is possible" if you expect to actually make any money on what you're developing.

I have never worked on a HW project where documentation development ended up being the critical path to product release. Not that it's impossible, but you'd almost have to try to make it happen.

SW, of course is an entirely different kettle of fish. There it's almost SOP.

Gene Kim-Eng


On 4/11/2016 6:03 PM, Keith Hood wrote:

It depends on how you define "finished". To ship with the product, the
documentation has to be clear, concise, well organized, easy to use, and
complete *as far as adequately covering the most important and most likely
uses of the product*.

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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
RE: Developments in the review cycle: From: mbaker
RE: Developments in the review cycle: From: Steve Hudson
RE: Developments in the review cycle: From: mbaker
Re: Developments in the review cycle: From: Keith Hood

Previous by Author: Re: Working Off Site
Next by Author: Re: Working Off Site
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