Brands, Products, Portals, UI Elements, and Action Verbs
Brands/Products/Portals
- Analytics by Liaison: refer to as “Analytics by Liaison” in first mention then just “Analytics” subsequently. No abbreviation.
- APPIC Application for Psychology Internships (AAPI): refer to as “APPIC Application for Psychology Internships (AAPI)” in first mention then just “AAPI” subsequently.
- Application Builder: refer to as "AppBuilder."
- Applicant Help Center (or Help Center): do not use “Instructions” or “Instructions and FAQs.”
- CAS Applicant Portal: interchangeable with “application” or “online application” in most instances.
- Centralized Application Service (CAS): refer to as “Centralized Application Service” in first mention then abbreviate to “CAS” subsequently. CAS is used mostly within sales, marketing, and internal communications as each client has a different CAS name that should be used in external communications.
- Compact2Learn: refer to as “Compact2Learn,” not “C2L.”
- Configuration Portal: sometimes referred to as "Config Portal," "CAS Configuration Portal," or "Configuration Manager."
- eAccreditation: only use "eAccred" abbreviation in internal communications.
- Enrollment Marketing: division in Liaison.
- Enrollment Marketing Platform (EMP): refer to as “Enrollment Marketing Platform” in first mention then abbreviate to “EMP” subsequently.
- Letters by Liaison: the recommender portal. You can use "Letters by Liaison, the Recommender Portal" for clarification, if needed.
- Liaison International: refer to as “Liaison International” in first mention then just “Liaison” subsequently. No abbreviation.
- Othot: refer to as "Othot."
- Outcomes: refer to as “Liaison Outcomes” in first mention then just “Outcomes” subsequently.
- TargetX: refer to as "TargetX," not "TargetX CRM." Only use "TX" abbreviation in internal communications.
- Time2Track: refer to as “Time2Track,” not “T2T.”
- University Centralized Application Service (UniCAS): refer to as UniCAS.
- WebAdMIT: only use “WA” abbreviation in internal communications.
Standard UI Elements
This list is adapted from the Microsoft Writing Style Guide.
- Window (not “dialog” or “pop-up”)
- Field (not “box”)
- Drop-down (not "dropdown" or "dropdown menu")
- For TargetX, use "picklist"
- Button
- You should generally omit the term “button” when describing a step or action as long as the placement of the button in the UI is obvious. For example, use “Click Save” instead of “Click the Save button.”
- Radio button
- Checkbox
- Type ahead field
- For TargetX, use "autocomplete"
- Page (not “screen”)
- Tab, subtab
- Panel, subpanel
- Channels (e.g., Applicant Channels and Status Channels)
- Menu bar (not “toolbar”)
- Scroll bar
- Icon
Since TargetX is built on the Salesforce platform, there are a few additional terms to use; see the Salesforce Glossary.
When documenting data type formats (e.g., exports from WebAdMIT), refer to Oracle’s help center for date/time format translations.
Standard Action Verbs for Web Apps
- Navigate: use when moving around a page or going to a feature (e.g., Navigate to the Settings icon").
- Search for: use in conjunction with another action (e.g., "Search for an applicant" or "Search for and select an applicant").
- Select: use when interacting with an item in a list (e.g., “Select Yes from the Payment Received drop-down”), radio button, or checkbox.
- Click: use when interacting with a button, menu, tab, or panel (e.g., “Click the Settings menu”). Always omit “on” when using this action (e.g., “Click the Applicant panel” instead of “Click on the Applicant panel”).
- Enter: use when inputting content in a text field (e.g., "Enter a title for the feature").
- Drag or Drag and drop: use when moving an item from one location to another (e.g., "Drag the item to set a sort order" or "Drag and drop the field into the export").
- Add: primarily for Time2Track; use with directions that involve a user adding information to Time2Track such as activities, faculty, supervisors, etc. (e.g., “add an activity” instead of “log an activity”).
- Create: use an introduction to a set of steps. Alternatively, if running a training, use to direct users to a multi-step process.
Standard Action Verbs for Mobile Apps
These are borrowed from the Apple Style Guide.
- Tap: quickly touch and release to select a control or item; equivalent to clicking on a Mac (e.g., Tap the song you want to play).
- Drag: move one finger across the screen or trackpad to scroll through items, drag items or controls, or pan around items (e.g., Drag to scroll through your list of songs, Drag the slider to adjust the brightness, Drag to see other parts of the map).
- Swipe: quickly slide one or more fingers across the screen or trackpad to reveal controls or to scroll through documents, lists, or groups of items. Implies a less controlled motion than dragging (e.g., Swipe over the note and tap Delete, Swipe left or right to move between dates).
- Pinch: move two fingers together or apart to zoom out or in (e.g., Pinch to zoom in on the page).
- Rotate: use two fingers to rotate images and other items (e.g., Rotate to change the photo’s orientation).
- Touch and hold: touch the screen or trackpad and hold until something happens (for example, the view is magnified, an item becomes editable, or a control appears) (e.g., Touch and hold a book, and then drag it to a new position on the bookshelf, Touch and hold a location on the map).