Naming conventions in a three-tiered system

Subject: Naming conventions in a three-tiered system
From: "Sue Ahrenhold" <SAhrenhold -at- IpdSolution -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 12 Feb 2003 10:52:07 -0500


We are documenting a tool that works in a distributed environment. Originally, the documentation talked about a Desktop client, a web client, and the Server. However, the PTB (powers that be) decreed that this product would be web only, so the desktop client went away, and the name of the web client was changed to the name of the product. However, the product contains a set of administrator tools that can be run on any machine.

So in the installation guide, the installer options are:
Administrator Tools
Server
Snap-On Applications

These snap-on applications have to be run from the server only.

Now, they are adding some new tools that can run from either the server or the same machine that the administrator tools run on, but that have a separate, unique installer.

My question concerns the headings we should use in the minimum system configuration table. Originally, the headings were:

Desktop
Web Client
Server

But officially, both Desktop and Web Client have gone away.

We've considered

Administrator Tools
[Product name]
Server

and

Desktop
End User
Server

but don't know exactly what to do.

Looking for conventions that other users might be following. Thanks!

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

Buy or upgrade to RoboHelp X3 today and receive the WebHelp
Merge Module for FREE ($299 value). RoboHelp X3's all-new
features include conditional text, completely re-engineered
printed documentation output, Context-sensitive Help Toolkit,
single-source layouts, and more!
Order online today at http://www.ehelp.com/techwr-l


---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



Previous by Author: RE: TW -> QA
Next by Author: RE: Single-sourcing Tool
Previous by Thread: RE: Basic Voice ??s: OK for Software to "allow", "let", "enable", "pr ovide" and so forth?
Next by Thread: RE: Any pharmaceutical tech writers out there?


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


Sponsored Ads