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.
Subject:Re: Phrasing recommendations From:Karen Field <KarenF -at- TRITECH -dot- COM> Date:Fri, 21 May 1999 11:21:14 -0700
We dealt with this a lot when I was at Intuit, and here's what we came up
with: Use the imperative and an objective point of view. For example, "For
best results, use the default..." The imperative is stronger than any "we
recommend..." or "It is recommended..." statements. Also, when you use the
imperative tone, you leave fewer unanswered questions for the user, such as,
"It is recommended by who? Why is it recommended?" Generally, all users want
the "best results." And you can qualify circumstances in which they wouldn't
choose the default in a note or subsection.