Skip to main content

Terminology

Consistent terminology ensures clarity and reduces confusion across Hardwater products.

General Principles

  1. Be consistent - Use the same term for the same concept
  2. Be clear - Use terms that are easy to understand
  3. Be concise - Prefer shorter terms when possible
  4. Be specific - Use precise terms, avoid vague language

Common Terms

Actions

TermUsageAvoid
SaveSave changes, dataStore, Persist
DeleteDelete item, accountRemove, Erase
CancelCancel actionClose, Dismiss
SubmitSubmit formSend, Post
CreateCreate new itemAdd, Make
EditEdit itemModify, Change
UpdateUpdate informationChange, Modify

Status

TermUsageAvoid
ActiveActive statusEnabled, On
InactiveInactive statusDisabled, Off
PendingPending statusWaiting, Queued
CompletedCompleted statusDone, Finished
FailedFailed statusError, Broken
TermUsageAvoid
HomeHome pageMain, Dashboard
SettingsSettings pagePreferences, Config
ProfileUser profileAccount, User
HelpHelp sectionSupport, FAQ

Forms

TermUsageAvoid
RequiredRequired fieldMandatory, Must
OptionalOptional fieldNot required
Email addressEmail input labelEmail, E-mail
PasswordPassword inputPass, Pwd
Confirm passwordConfirm passwordRe-enter password

Messages

TermUsageAvoid
SuccessSuccess messageSuccessfully, Done
ErrorError messageFailed, Problem
WarningWarning messageCaution, Alert
InformationInfo messageNote, Tip

Brand-Specific Terms

Hardwater

  • Project - Main work unit
  • Task - Work item within a project
  • Team - Group of collaborators
  • Workspace - Organization or company space

Hardwater Studios

  • Portfolio - Collection of creative work
  • Project - Creative project
  • Asset - Creative asset (image, video, etc.)
  • Studio - Creative workspace

Technical Terms

When technical terms are necessary:

  1. Define on first use - Explain technical terms when first introduced
  2. Use consistently - Once defined, use the same term
  3. Provide context - Help users understand technical concepts

Example:

"API (Application Programming Interface) allows different software to communicate with each other."

Avoiding Jargon

Prefer plain language over jargon:

JargonPlain Language
LeverageUse
UtilizeUse
FacilitateHelp, Make easier
ImplementAdd, Create
ExecuteRun, Do

Regional Variations

Use American English spelling and terms:

  • Color (not colour)
  • Organization (not organisation)
  • Center (not centre)

Resources