Dropping the you? The Asian response to imperative voice. (was: Re: you or he/it)
Monica Cellio
cellio at pobox.com
Thu Jun 22 20:12:51 MDT 2006
> Sean Hower noted: <<no one has suggested that you could simply adopt a
> style that uses neither you nor the user. That would eliminate this
> entire discussion. For example: You can use the color picker to set the
> background of your pages. can be rewritten as Use the color picker to
> set the background color for pages.>>
The imperative can work well for direct, procedural material. I'm
having trouble imagining how it would work when writing more open-ended
documentation, such as when giving advice about the alternatives available
to the reader. 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 generally find the second person to be the least-awkward approach,
even when writing for translation. But I also take to heart the
comments about negative feedback being hard to get; thanks for the
tip.
Monica Cellio
Senior SDK Developer
I don't represent my company (which is why I don't name it).
More information about the TECHWR-L
mailing list