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