Mirakl Design
Mirakl Design
  • Getting started
    • Welcome to Roma
      • Design principles
  • Design
    • Components
      • Actions
        • Action menu
        • Buttons
        • Button group
        • File download
        • Save bar
        • Tasklist
        • Contextual Toolbar
      • Datalist
      • Datatable
      • Feedback
        • Alerts
        • Activity Loader
        • Badge (status)
        • Empty state
        • Snackbar
      • Form
        • Fields
        • Pickers
        • Selection controls
        • Tree
      • Images
        • Illustrations
        • Icons
        • Media
      • Navigation
        • Hyperlink
        • Page title
        • Sidebar
        • Top bar
      • Overlays
        • Modal
        • Popover
        • Tooltip
        • Side Drawer
      • Structure
        • Global layout
        • Panel
          • Activable Panel
          • Clickable Panel
          • Expandable Panel
          • Panel tabs
          • Totalizer Panel
        • Card
    • Patterns
      • Advanced selection
      • Configure options
      • Displaying data
      • Displaying history
      • Errors
      • Forms
        • Form - Creation mode
        • Form - Edition mode
        • Form - In a modal
        • Error Management
        • Stepper form
        • Onboarding form
      • Loading
      • Progressive disclosure
  • content
    • Writing for Mirakl
      • Grammar and formatting
    • Vocabulary
      • Mirakl products
      • Which verb to use
Powered by GitBook
On this page
  • Save vs OK vs Done
  • Activate vs Enable
  • Deactivate vs Disable
  • Create vs Add
  • Delete vs Remove
  • Compute vs Calculate
  • Select vs Choose
  • Cancel vs Discard
  • View vs See
  • Display vs Appear
  • Next vs Continue
  • Deprecate vs Depreciate

Was this helpful?

  1. content
  2. Vocabulary

Which verb to use

Save vs OK vs Done

Use Save when a change is saved immediately. If the context is not clear enough or you feel the need to emphasize the action, use the Save + [noun] structure.

Use Done when you need users to confirm a change or an update (usually in a modal) before saving all the changes at the end of a flow.

Use OK when you need users to confirm they've read a message, an announcement for example.

Activate vs Enable

Use activate when the meaning is to put into action immediately.

As an operator, you then decide to activate the feature for your sellers.

Use enable when the meaning is to give the ability to perform an action.

Ask the Mirakl Support Team to enable this feature.

Deactivate vs Disable

Use deactivate when the meaning is to put into action immediately.

As an operator, you then decide to deactivate the feature for your sellers.

Use disable when the meaning is to give the ability to perform an action.

Ask the Mirakl Support Team to disable this feature.

Create vs Add

Use Create when you want operators or sellers to design something new within Mirakl.

  • Create store

  • Create channel

  • Create order

  • Create user

  • Create product

  • Create shipping method

Use Add when you add a characteristic to an existing Mirakl object.

  • Add a shipping fee (to a shipping method)

  • Add price (to a product)

Delete vs Remove

Use Delete if the item ceases to exist.

Use Remove if the item still exists after its removal.

Compute vs Calculate

Compute and calculate are almost always interchangeable, as are the related forms “computation” and “calculation”.

We use a calculator to perform simple arithmetic operations, whereas a computer is typically used to perform complicated tasks, often involving complex algorithms. You may therefore use the words “calculate” and “calculation” to indicate simplicity and “compute” and “computation” to indicate complexity.

Select vs Choose

Use Select if the user needs to make a choice within a dropdown menu or when the choice sounds very obvious, like selecting a country or a file.

Use Choose for more informal or subjective questions.

Cancel vs Discard

Use Discard if the user is about to delete any data, for example, abandoning changes made to a form and staying on the page.

Use Cancel if the user wants to stop a specific action, for example, stopping the creation of a user and exiting the page.

View vs See

Use View to make more information appear on the interface or to push users to another page on Mirakl.

View order details

Show is a synonym, but we prefer to use View.

Use See when writing more generic sentences.

Display vs Appear

Use Display when referring to something already visible on the back-office interface.

The Orders page displays information.

Use Appear when referring to a pop-up or a message shown in a dedicated dialog box on the back-office interface (usually the consequence of an action).

A confirmation message appears.

Next vs Continue

Continue in the user interface, usually the Save bar, as we prefer verbs.

Deprecate vs Depreciate

Only use deprecate, but as it sounds technical, you may also use expressions such as "no longer recommends using".

Mirakl has deprecated the import feature.

Last updated 1 year ago

Was this helpful?