Business and Technology Requirements documents

Subject: Business and Technology Requirements documents
From: Stuart Burnfield <slb -at- FS -dot- COM -dot- AU>
Date: Wed, 23 Apr 1997 14:15:47 +0800

Gaye -

It's just like walking in flippers: the best way to do it is backwards.

What minimum of information is needed in the 'Define & Design' documents
for everyone on the team to get started on their jobs?

- QA people to draft a test plan
- marketing people to draft marketing lit.
- tech writers to write an information plan
- engineers/developers to produce detailed specs or prototypes

If your starting point is "what's supposed to be in a requirements
document?", you're likely to end up with fluff -- how great the product
is going to be, some interesting facts about the product, whose idea it
was, how we intend to optimise the sorting algorithm, etc.

A more practical approach is to start with the stakeholders --

"The 'CamelCaps! Pro for Windows 95 Lite' Requirements Document will be
ready on 30 April. You have to deliver a draft documentation plan on 7
May. What information do you need there to be in the requirements docs?"

"The 'CamelCaps! Pro for Windows 95 Lite' Requirements Document will be
ready on 30 April. You have to deliver a draft QA plan on 7 May. What
information do you need there to be in the requirements docs?"

And so on. Ideally, it should be possible for people with no prior
involvement in the project to write the specs, QA plan, brochures, etc.,
purely from the final requirements docs.

Regards
---
StuartBurnfield! Lite (slb -at- fs -dot- com -dot- au) Voice: +61 9 328 8288
Functional Software Pty Ltd Fax: +61 9 328 8616

TECHWR-L (Technical Communication) List Information: To send a message
to 2500+ readers, e-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send commands
to LISTSERV -at- LISTSERV -dot- OKSTATE -dot- EDU (e.g. HELP or SIGNOFF TECHWR-L).
Search the archives at http://www.documentation.com/ or search and
browse the archives at http://listserv.okstate.edu/archives/techwr-l.html


Previous by Author: Re: Other Style Guides
Next by Author: Usability: Tutorial *chapter* or *manual*
Previous by Thread: Re: Question about MSWord (longish)
Next by Thread: Re: Business and Technology Requirements documents


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

Sponsored Ads


Sponsored Ads