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.
RE: Dropping the you? The Asian response to imperative voice. (was: Re: you or he/it)
Subject:RE: Dropping the you? The Asian response to imperative voice. (was: Re: you or he/it) From:"Jones, Donna" <DJones -at- zebra -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Fri, 23 Jun 2006 09:00:58 -0500
Monica Cellio asked:
How would you rewrite something like this (in a
sys-admin or programming manual)? "If most of your users are located
in one facility, we recommend using the standard client-server
configuration. If most of your users are in remote locations, or if
any have slow or unreliable network connections, we instead recommend
using the multi-server configuration with the following modifications
[...]."
I would put the information into a table or bulleted list, which gets
rid of the need for "we" as a subject. It also makes it easier for the
reader to find the appropriate situation and the recommendations. (I
broke it down into three situations here, which may not be correct, but
you can still see where it's going.) You could even add in
cross-references to the configuration instructions without cluttering
things up to the point that it's unusable.
Select a server configuration based on the following recommendations:
Situation Recommended Configuration
Most users located Standard client-server
in one facility
Most users located Multi-server
in remote locations
Slow or unreliable Multi-server with the
network connections following modifications:
- XXX
- XXX
OR
The recommended server configurations vary in different situations:
- STANDARD CLIENT-SERVER--Used when most users
are located in one facility.
- MULTI-SERVER--Used when most users are located
in remote locations.
- MULTI-SERVER WITH MODIFICATIONS--Used with slow
or unreliable network connections. Modifications
may include...
Dancing on top of my desk because it's FRIDAY!!! I love my job, but I
love the weekends even more! :-)
--Donna
- CONFIDENTIAL-
This email and any files transmitted with it are confidential, and may also be legally privileged. If you are not the intended recipient, you may not review, use, copy, or distribute this message. If you receive this email in error, please notify the sender immediately by reply email and then delete this email.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!. http://www.webworks.com/techwr-l