6.7. RFRS Considerations

The "User Interface" section of the RFRS Requirements includes one best practice dealing with actions. It is derived from the Eclipse UI Guidelines.

6.7.1. Global action labels (RFRS 5.3.5.1)

User Interface Guideline #3.3 is a best practice that states:

Adopt the labeling terminology of the workbench for new, delete, add, and remove actions. For consistency, any action that has a similar behavior to existing actions in the workbench should adopt the same terminology. When creating a resource, the term "New" should be used in an action or wizard. For instance, "New File", "New Project", and "New Java Class". The term "Delete" should be used when deleting an existing resource. When creating an object inside a resource (e.g., a tag in an XML file), the term "Add" should be used; the user is adding something to an existing resource. The term "Remove" should be used to remove an object from a resource.

To pass this test, create a list of the actions defined by your application and demonstrate their use. Show that the terms New, Delete, Add, and Remove are used properly and consistently with the workbench. In the case of the examples presented earlier in this chapter, it is preferable to show the Favorites editor actions (see Figure 6-10) and describe their use to the reviewers.