You can introduce ambiguity when you use the expression Avaya recommends. Only use Avaya recommends if it is important to indicate that you are providing a recommendation. Otherwise, use the imperative form. Avoid positioning a best practice as a recommendation. Overusing Avaya recommends can cause unnecessary and costly escalations, especially when important information is buried within a recommendation. If there are consequences to not following a recommendation or best practice, you must inform the user about these consequences. In a situation where a user can perform more than one action, document all options, including the expected consequences, so that the user can make an informed choice.
Preferred |
Discouraged |
Do not change database names. |
Avaya recommends that you do not change database names. |