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.
> >I don't consider Busness Requirements (BR) as important as
> Functional
> >Requirements (FS), except to write the FS, and if whoever is
> writing the FS
>
> Doesn't this depend on the audience? Developers really don't care
> about
> 'why' an application needs to be developed. Maybe thorough
And I don't either. By the time I'm involved, it has been decided
that there is a need for the application. At that point, I wan to
start being involved. I want to be at the meetings before coding has
started, while they are figuring out what features to code. However,
I don't say much at those meetings, not yet. At this point, I'm just
a chicken...I'm just there to get a feeling on the scope...how much
resources will I need and how big an effort is this, because I'm
doing my own planning for the parts coming where I'm the pig.?
> Business units (stakeholders), on the other hand, want to
> see this same information one level higher. They don't want
> to read how the A2 app does what it does, they want to know
> why they've invested their resources in the
They're big boys and they've done this before...lt them figure that
out..they don't need my help.
> The functional requirement of this would be "The A1 system will
> provide FTP functionality..."
Not the functional specs that I'll accept and sign off on. The FS
that I'll accept will say how our application performs FTP. Through a
CLI? Through a GUI? Security and credentials? What get's FTP'd? etc.
I may not care too much about BRs, but I'm a prick when it comes to
what I'll accept in an FS from which I need to work if I'm not
writing it..
John Posada
Senior Technical Writer
"They say everyone needs goals. Mine is to live forever.
So far, so good."
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help & Manual: http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
