Need examples of system documentation

[deltaskye <deltaskye -at- yahoo -dot- com>]

I am returning to IT system tech writing after an absence of four years. My client wants me to document a system that is already in place; the engineer who designed it did not write anything down! 

I will be working with a new engineer to try to document the system (not for end-users, for the company's internal/engineering use). The engineer will be the technical SME and I will be the scribe and desktop publisher. The system is used by staff to register new customers for a service, document customer service calls, and transmit each day's activities to another system.

The engineer has asked me to provide him some examples of what the documentation might look like. I have all kinds of stuff generated when other customers followed an organized SDLC as they were designing a system. I'm looking for ideas on how to frame the documentation as the engineer and I try to document a system that someone else designed (and who is no longer available).

I don't know if the following is helpful, but here are some of the topics the engineer has suggested:

External data interfaces
Oracle database management system
BEA configuration
System backup/restore

Thanks!



      
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help gives you everything you need to author and 
publish quality Help, Web, and print content. Perfect for technical 
authors, developers, and policy writers. Download a FREE trial.
http://www.componentone.com/DocToHelp/

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- 

To unsubscribe send a blank email to 
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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
http://www.techwr-l.com/ for more resources and info.