RE: New position myself - need advice on requirements

Subject: RE: New position myself - need advice on requirements
From: Kevin McLauchlan <kmclauchlan -at- safenet-inc -dot- com>
To: 'Keith Hood' <klhra -at- yahoo -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 25 Apr 2007 10:51:28 -0400

Keith Hood

> I just started on a new contract, and am already
> behind.

> parts of the
> system will basically just be moved to Java from C++.
> The developers are so familiar with the functioning of
> the existing systems they refer to them as prototypes
> for the one under development.
> So, any advice on how to proceed at this point? The IT
> director wants to finish the BRs first off, and soon,
> because the higher-ups are clamoring for them. I'd be
> especially interested in getting advice in how to
> shape requirements for reading by high level execs as
> opposed to reading by software shop code bashers.

Gee, I guess I have it bass-ackwards.

I would have thought that the BUSINESS REQUIREMENTS (sorry for shouting) are
developed by the people who... oh... you know.... SET THEM!!

Those, by the way, would be Product Managers and Biz-development honchos who
have been researching the market, dealing with customers, ascertaining their
needs and wants, and determining what a new product/version must have/do in
order to fly.

The only way a tech writer should be writing Business Requirements is if
s/he has been living in the pocket(s) of the Product Managers and Biz-dev
people and writing said documents while closely attending the meetings and
discussions by which those requirements actually gelled in the minds of
those who actually have the authority and responsibility to do so. Well,
actually the writer might more likely work from notes and meeting minutes
created by those people... but they are the source, not the techwriter.

It seems that you weren't there "when" that process occurred, and it further
seems that maybe that process didn't actually happen. So you have no source

If they are laying all that responsibility on you, teach 'em all a lesson.
Write up a plausible-sounding set of biz-related requirements, but be sure
to include a hover mode and parsec-traversal function.

Now, if the previous writer has a directory full of meeting notes and e-mail
trails from the folks who ALREADY SET the business requirements, then you do
have a starting point to build a document. Quickly send out an e-mail
announcing that you've discovered "partial" notes and will be investigating
with "stakeholders" (always a good buzzword) to determine where the gaps are
and what should go in 'em.

Above all, manage expectations.


The information contained in this electronic mail transmission may be privileged and confidential, and therefore, protected from disclosure. If you have received this communication in error, please notify us immediately by replying to this message and deleting it from your computer without copying or disclosing it.

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.

Now shipping: Help &amp; 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 &amp; Manual:

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

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 for more resources and info.

Previous by Author: RE: New position? - FEEDBACK NEEDED
Next by Author: classes
Previous by Thread: RE: Active vs. Passive Voice
Next by Thread: Look out below!!!! WAS: A semi-hard landing...

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

Sponsored Ads