Home
Messages - Do you know how to make message boxes user friendly? (1/3 Titles)
  v2.0 Posted at 27/11/2012 3:35 PM by Rebecca Liu

Message boxes should have consistent and informative titles and descriptions, and icons should be used appropriately.

Title

The title should contain the application name, so the user knows what application generated the warning/error. This is especially important when developing add-ins (e.g. Outlook add-ins or Smart Tags) as it can be difficult to know what caused the message box to pop up. Application.ProductName and Application.ProductVersion should be used to retrieve the data from AssemblyInfo. There is no need for the title to contain a brief description of the error because that information is readily available in the message box itself.
Bad Title Example
Figure: Bad Example - Title contains brief description of error, which is already contained in the message box
Good Title Example
Figure: Good Example - Title contains Product Name ("SSW eXtreme Emails!") and Product Version ("12.56")
We have a program called SSW Code Auditor to check for this rule.
Note: The Version Number in the title should only contain the Major and the Minor version numbers (e.g. 11.28) and not the complete Major.Minor.Revision.Build Numbers (e.g. 11.28.92.1198)

Related rules

    Do you feel this rule needs an update?

    If you want to be notified when this rule is updated, please enter your email address:

    Comments:

    Note: Social Media login for Yotpo is not working in IE or Safari, please use Chrome. We are waiting for Yotpo to fix it.