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.
The situation is convoluted. A consulting firm came in over a year ago to develop the business and functional requirements for the A2 system. I don't know if there was a gas leak at the time, but the documents that I read were of little value. The "requirements" that the firm listed were not requirements at all and I was able to reduce the list of 680 down to 120. For political reasons, that list was thrown out and another firm was hired to start at square one (the developers are supposed to start working on 6/1).
There are three items that I can clarify.
First, I'm not a gun-slinger who decided that these requirements (for both the legacy app and A2) needed to be written. I was given that assignment.
Second, the legacy app documentation is mostly for the stakeholders so that heads *don't* roll if they ask to see the current documentation. The emphasis was on generating this first.
Third - and I say this with respect - John was incorrect when he said that I had been shot down once before regarding this. That incident/post referred to a completely different project. And again, I'm not playing Cowboy Bob shooting my way into board rooms trying to sell my agenda. My manager tells me what he'd like and I do it.
From: Mary Arrotti <mary_arrotti -at- yahoo -dot- com>
I think it's fine & actually your responsibility to raise the issue if the lack of bus reqs adversely affects your job or your ability to produce documentation. Not sure if that's the case here. As I understand it - you're not even working on the legacy app. If you think there is a need for documentation for that product & anticipate problems if your org doesn't include docs - then I'd recommend bringing that to everyone's attention. But if you're not working on the product & not protesting that - then pushing for bus reqs may seem a bit presumptuous.
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-