Use of "please" in technical documentation and messages on screen
Mike Wickham
info at mikewickham.com
Fri Jun 26 05:24:19 PDT 2009
I don't know about the rules of technical documentation, but "please wait"
sounds much better than just a command to wait.
More importantly, I love that you didn't use passive voice. You used
"updating the result list" instead of the typical, "the result list is being
updated." Bravo!
Mike Wickham
----- Original Message -----
> Hi
> Once I learned that you shouln't use the word "please" in technical
> documentation - that it was like asking the reader to do you favor.
>
> Does this still hold true? Is it OK to have this message displayed on
> the screen of our user interface?
>
> "We are updating the result list, please wait"
>
> Best regards,
>
> Verner
More information about the framers
mailing list