[1323] in SIPB-AFS-requests
Re: server migration
daemon@ATHENA.MIT.EDU (Marc Horowitz)
Fri Apr 15 17:54:11 1994
To: rei@MIT.EDU
Cc: eichin@MIT.EDU, warlord@MIT.EDU, sipb-afsreq@MIT.EDU,
charon-maintainers@MIT.EDU, rtfm-maintainers@MIT.EDU,
webmaster@MIT.EDU, usenet@MIT.EDU
In-Reply-To: Your message of "Fri, 15 Apr 1994 17:38:38 EDT."
<9404152138.AA15627@pesto.MIT.EDU>
Date: Fri, 15 Apr 1994 17:53:37 -0400
From: Marc Horowitz <marc@cam.ov.com>
>> Speaking of the office manual, if people would care to write up stuff
>> describing (in non-highly-technical terms) what our services are and
>> how to maintain them, this would be way cool :)
I think that a section describing how to maintain a service should not
try too hard to be "non-highly-technical". One should not be
gratuitously obscure, but softening the language will usually make it
less accurate, making it harder for someone technical to use it, and
not making it any more useful for the less technical. (None of this
applies to the sections describing what the services are, only the
ones on how to maintain them.)
Since I don't have time to actually write anything, I'll shut up now
:-)
Marc
