Terminology
Terminology refers to how words are defined for labels and titles.
Principles
- Don't be redundant
- Avoid using new with Create or Add, as it is redundant.
- Be active
- Use calls to action (such as, Register Now) for section headers when users are being asked to do something with that content to urge them to take an immediate action. Avoid using the progressive form of the verb. For example, use Edit instead of Editing.
- Specify objects with actions
- Include the target with action labels to make it clear what the user is about to do, for example, Create Course Offering. However, because a Cancel link is in proximity to a button specifying a specific task and object, it does not need to include the object in its own label (Cancel Course Offering).
- Soften headline tone
- Use articles in page titles to soften tone and help the reader parse the key words. For example, Create a Course.
Action words
- Add
- Starting or completing an action that will change the current user interface, such as adding a new row to a collection.
- Attach
- Linking a digital object originating outside the system to an internal document, such as attaching a document to a course proposal.
- Cancel
- Returning to the originating page without intended action taking place.
- Create
- Instantiating a new data object, such as adding a new course offering to the database.
- Edit
- Beginning a task to change information attached to a document, such as editing a course offering.
- Join
- Linking two documents within the system.
- Manage
- Manipulating a set of objects, often children of the selected primary object, by adjusting the relationships between them or performing bulk actions across multiple objects.
- Preview
- Displaying an incomplete state of an object that is currently being edited or created.
- Publish
- Changing the state of a document to make its contents viewable by an external audience.
- Remove
- Unlinking a digital object from an internal system document.
- Save
- Completing an edit or create task.
- Submit
- Sending a document into a workflow without saving data to the server, such as submitting a course proposal for review.
- View
- Displaying an entire read-only document.
- View Details
- Displaying a read-only subset of a full document record.