TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Re: Writing a product functional spec AFTER the product is built
Subject:Re: Writing a product functional spec AFTER the product is built From:Tara English-Sweeney <tens00 -at- gmail -dot- com> To:Bill Swallow <techcommdood -at- gmail -dot- com> Date:Mon, 28 Jun 2010 08:11:35 -0400
Thank you Bill. I agree wholeheartedly about the quirkiness of writing this
after the product is built. However, we all know that sometimes we have to
do what we are asked and what is needed. The direction of what is needed
came straight from sales and our team of product managers. There were
earlier attempts at this document so there are very clear expectations as to
what they want. I had a different vision of this document but our sales team
expects what they are used to and I'm relatively new to the company. I
tried. Thank you for your feedback!
On Sun, Jun 27, 2010 at 11:07 PM, Bill Swallow <techcommdood -at- gmail -dot- com>wrote:
> > Hello. I am wondering how often technical writers have been asked to
> write a
> > product functional specification after a product has been built. I have
> been
> > working feverishly on one. The goal is for it to be used as a sales tool
> and
> > even more importantly, to ensure that customers have a clear definition
> of
> > the the features and functions (via use cases) so there is no
> > misinterpretation.
>
> You want to research 'reference guide'. After the product is built is
> far too late for a functional specification. That should have been
> written in draft form well before any actual product code was written,
> and evolved as changes were made to the functional design of the
> product.
>
> You may want to talk to sales about just what they need, as well.
> Though giving customers a clear definition of the features and
> functions is important, this is different from a technical sales
> document, and very different from a functional specification (which
> would normally contain highly proprietary information).
>
> --
> Bill Swallow
>
> Twitter: @techcommdood
> Blog: http://techcommdood.com
> LinkedIn: http://www.linkedin.com/in/techcommdood
>
> Available for contract and full time opportunities.
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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-