Re: system administrators and documentation

Subject: Re: system administrators and documentation
From: dmbrown -at- brown-inc -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Mon, 26 May 2003 11:07:47 -0700


Brian Das wrote:
>
> So, the strategy seems to be: Provide information that's
> only useful to people who already know the product well.
> Less experienced people will get frustrated and call us
> for consulting hours.

I wouldn't look at it so cynically. Try turning it around.

I assume that the system is complex, that setup is not a trivial task, that it's important for the system to be set up correctly, and that failure to set up the system correctly might well lead to dissatisfaction with the product.

Given those assumptions, you really don't want "just anybody" trying to set up the system and missing some crucial element. If that happens, the only solution is lots of frustrated calls to Tech Support. It's *much* better to get the system set up properly from the very beginning, so the customer gets the most out of the product and has a totally positive experience.

For the customer with a mature, experienced IT department, the highly technical information in your admin docs will be perfectly appropriate. (Make sure it is!)

For the customer without the necessary in-house expertise, the complex nature of that material may be just the "push" they need to contract with your Consulting group for assistance, rather than trying to do it themselves.

The benefits of this strategy:

* The customer gets a properly configured system, helping
ensure their satisfaction with the product.

* Set-up is properly documented--that's important, even
for the members of your Consulting group.

* You contribute (visibly!) to your company's success,
because Consulting is a profit center, whereas Tech
Support probably isn't.

* You demonstrate that you can understand and document
highly technical material, increasing your acceptance
by the developers and your value to your employer.

* You may get to learn about previously unfamiliar
technologies, like database configuration and network
protocols.

Sounds like a win for everyone.

--David

========================================================================

HTML Indexer 4 is still the easiest way to create and maintain indexes
for web sites, intranets, HTML Help, JavaHelp, and other HTML documents.

HTML Indexer 4 includes fully integrated cross-references, target frames
and windows, multiple-file output, "one-step accept" of default entries,
and more!

http://www.html-indexer.com/

 

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

Robohelp X3, from eHelp, lets you quickly and easily create
professional Help systems for all your Windows and Web-based
applications, including Net.

Order RoboHelp X3 in May and receive a $100 mail-in rebate, PLUS
free RoboScreenCapture and WebHelp Merge Module.

Order RoboHelp today: 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.



References:
system administrators and documentation: From: Brian Das

Previous by Author: Re: Going from employee to contractor: setting a rate
Next by Author: Re: system administrators and documentation
Previous by Thread: Re: system administrators and documentation
Next by Thread: Re: system administrators and documentation


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


Sponsored Ads