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: A Long Time Ago From:Richard Lewis <tech44writer -at- yahoo -dot- com> To:Jay Maechtlen <techwriter -at- covad -dot- net>, vrfour -at- verizon -dot- net, TechWrl list <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Tue, 18 Sep 2007 06:38:28 -0700 (PDT)
James Barrow wrote:
The developers for the new app have been hired and are sitting in the cubicle farm...doing nothing. Why? Because they need some sort of documentation for the legacy app before they can proceed.
Generic Richard Responds:
The importance of the As-Is used to be widely recognized. Now, most seem unaware of As-Is documentation. Indeed, look at the current tool popular tool for functional modely - Use Cases. As they are typically, employed, the analyst forgets about the As-Is and jumps right into the To-Be. And everyone sits around and says Gee Wizzz, I just don't get we can not get away from so much hacking.
> Enter the PMO. "Oh no, no, no. You must document every process and
> procedure, for every module, for every facility." This increases the doc
> plan to 133 documents...due on April 13. Doable? I have no idea any more.
Generic Richard :
This is one of the basis of bad analysis. Successful analysis is based on a focus on the essential. The less important needs to be postponed till the appropriate time.
Need a vacation? Get great deals to amazing places on Yahoo! Travel.
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
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-