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.
Subject:Re: What is a Technical Specifications document? From:Jane Bergen <jbergen1 -at- EARTHLINK -dot- NET> Date:Mon, 22 Feb 1999 11:51:01 -0600
Technical specifications are developers/programmers notes on why, how,
and when for the project. They tend to address only technical issues
and are not intended for users. Sales and marketing folks often use
them to develop their strategies, and QA/testing uses them to develop
their test plans.
Although the technical specs are indeed written by the developers,
most of the time the developers are happy (unless there are bad
political vibes going on in a company) to pass it by the tech writers
for a sanity check. At least the developers I've worked with are happy
to do this. It helps me a lot, too, when I begin my documents. And
when the specs are approved by the powers-that-be, I always keep a
copy in my project notebook and update them as updates are issued.
Jane Bergen
----- Original Message -----
From: Parker, Cassandra M. (EXCH) <CMPARKER -at- INTERMEDIA -dot- COM>
To: <TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU>
Sent: Monday, February 22, 1999 10:03 AM
Subject: What is a Technical Specifications document?
>Hi everyone,
>
>I'm trying to find out how to write a Technical Specifications
document.
>
>Is it usually written by a Tech Writer or the Programmer of an
application?
>There is a little debate about this subject in my immediate
department.
>
>I welcome your views and comments.
>
>
>
>Thanks,
><><><><><><><><><><><><><><><><>
>Cassandra Parker
>Information Services - Tampa, FL
>Applications Delivery - QA
>(813) 829-6560
><><><><><><><><><><><><><><><><>
>
>
>=====================================================================
======
>Send commands to listserv -at- listserv -dot- okstate -dot- edu (e.g., SIGNOFF
TECHWR-L)
>
>
>