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.
Hi Kevin. I think Gene is on the money - trying to do this with a combination of text and static diagrams is probably doomed.
Flash might work for showing the dependencies in a generic way. But what about an applet? You could get the user to enter some timeout values (e.g. 60 secs for component D) then let them step through the key startup events to see what happens in that scenario. Picture a component diagram with a timeline control beneath it. The user can click D on the timeline and select its state (starting up; started; failed; timed out). The component diagram changes to reflect the state of the other components at this point. For example, component F is greyed out because it tried to start up before D came back.
Your company might think this too elaborate and expensive a solution, but it should make configuration much more reliable. And it would be fun to do!
Stuart
Gene said:
> ...people trying to set up things they find under their
. Xmas trees often go into a fugue state when confronted
> with flow charts. We used Flash animations instead.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days. http://www.doctohelp.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-