In most situations, reference the element type unless the reader will not understand what you are describing. For example, most users are not familiar with terms such as combo box, spin box, and group box. Therefore, describe these elements generically in a way users will understand.
Preferred |
Discouraged |
In the Customer Information area, enter your first name, last name, and user ID. |
In the Customer Information group box, enter your first name, last name, and user ID. |
Enter the time or use the arrows to modify it. |
In the Time spin box, modify the time. |
Refer to a button by the label only unless additional clarification is required. If the interface displays an icon image with no text, include the image in procedures and other documentation content. Ensure that you include alt text for images.
Preferred |
Discouraged |
Click Cancel. |
Click the Cancel button. |
Click to attach a file. |
Click the paperclip icon to attach a file. |