RE: Beta documentation quality

Subject: RE: Beta documentation quality
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: "'Michael Herman (Parallelspace)'" <mwherman -at- parallelspace -dot- net>, "p -dot- vuncanon -at- att -dot- net" <p -dot- vuncanon -at- att -dot- net>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 5 Apr 2010 23:07:10 -0700

Michael Herman wrote:

> The quality goals for the beta version of the documentation depends on
> the
> business, marketing and technical goals of the beta program for this
> particular product release well as the type of and audience for
> the
> product. That is, there isn't as simple generalization.

I agree. But that said, when pressed, my boss and I tell people we're aiming for beta docs to be 60-75% complete.

And I try to emphasize that tech pubs sees a beta test as an opportunity to test the docs and get valuable feedback on them -- what's missing, unclear, incomplete, etc. -- just like the developers hope to get valuable feedback on the application.

Sometimes we actually do get good feedback! :-)

Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom


Use Doc-To-Help's XML-based editor, Microsoft Word, or HTML and
produce desktop, Web, or print deliverables. Just write (or import)
and Doc-To-Help does the rest. Free trial:

Explore CAREER options and paths related to Technical Writing,
learn to create SOFTWARE REQUIREMENTS documents, and
get tips on FUNCTIONAL SPECIFICATION best practices. Free at:

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

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 for more resources and info.

Please move off-topic discussions to the Chat list, at:

Beta documentation quality: From: p . vuncanon
RE: Beta documentation quality: From: Michael Herman \(Parallelspace\)

Previous by Author: RE: How do I recover my old stuff?
Next by Author: RE: Writing dimensions
Previous by Thread: RE: Beta documentation quality
Next by Thread: Re: Beta documentation quality

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

Sponsored Ads