Re: Writing a product functional spec AFTER the product is built

Subject: Re: Writing a product functional spec AFTER the product is built
From: Peter Neilson <neilson -at- windstream -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Mon, 28 Jun 2010 08:17:46 -0400

Gene Kim-Eng wrote:
> ...
> In cases where the product is highly "cutting edge," such as scientific
> instrumentation, you're very often walking a very fine line between giving
> customers the information they need to make a purchase decision and giving
> competitors the information they need to steal your design.

Additionally, there is usually a very, very short time window during
which the information is useful. More than maybe six months and the
competition (or your own company) has a newer, better version going out
the door.

I'm thinking that the company would be well served by a plan to develop
two separate documents. One is the product specification that you're
being asked to create. The other is the design spec for the next version
of the product. It shouldn't take you more than two or three days to put
together a separate docplan for each of those two documents, and then
another three days to get both plans reviewed. Generally a documentation
project that has a good documentation plan has greater likelyhood of
success than one that does not. If someone tells you that there is "no
time" to do a docplan, then THAT is his plan, and it's something you'll
have to work around.

Having the two distinct docplans will enable you and your experts to
distinguish the goals and non-goals of each.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Gain access to everything you need to create and publish information
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days.
http://www.doctohelp.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.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Writing a product functional spec AFTER the product is built: From: Tara English-Sweeney
Re: Writing a product functional spec AFTER the product is built: From: Gene Kim-Eng

Previous by Author: Re: Distinctive writing style obfuscator
Next by Author: Re: Confluence "Free Trial" frustrations
Previous by Thread: Re: Writing a product functional spec AFTER the product is built
Next by Thread: RE: Writing a product functional spec AFTER the product is built


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


Sponsored Ads