Liferay.Design / Lexicon
/
Get Started
    Writing
Resources
Part of Liferay, IncCode/Content Licenses

Principles

Sign In
DocumentationPending

Clarity, confidence, and consistency in messaging promotes product reliability.

Words give meaning to your meticulously designed product. Without the proper messaging for your product’s navigation and functionality, uncertainty creeps into your users minds. The messages and naming conventions you use throughout your product complement its design. No matter how well-constructed your design, poor messaging can doom your product’s effectiveness. Clarity, confidence, and consistency in messaging promotes product reliability.

Clear

Clear writing is important in guiding users through Liferay’s products. Longer, more detailed text is not always more helpful. As a rule, we should make it easy to understand important. Be concise and specific; understand your user’s needs in a given situation, and provide them with just enough information to be successful.

  • Use simple, natural language.
  • Remove unnecessary messaging for obvious interactions.
  • Remove unnecessary words or irrelevant ideas.
  • Start phrases/sentences with an objective.
  • Rely on progressive disclosure and documentation to fill in gaps in understanding.


SPA pages may load slowly for users using Internet Explorer. Disable SPA to work around this issue.


Do

In order to work around a but in the Trident rendering engines (used by E11) and MSHTML rendering engine (used by Edge), properly rendering tthe page witth SPA currently requires re-downloading all CSS files on all page navigations for all Internet Explorer browsers, which can cause pages to load more slowly with SPA enabled than with SPA disabled. Disable SPA to work around this issue.


Don't

Current

Liferay’s products live in the present, they exist to help users now. Our communication should be positioned around current happenings and the actions needed to move users towards their goal.

  • Speak in present tense.
  • Describe current context.


Register to download


Do

You can start this download after registering.


Don't

Confident

Set a tone that will increase trust and confidence. Confident communication will put users at ease when making difficult decisions. Generally speaking, confidence will be inspired by clarity, consistency, and use of an active voice.

  • Use an active voice.
  • Don’t be arrogant. Avoid saying things that are self aggrandizing like best of breed and unrivaled analysis.


Download complete


Do

You have completed a download at lightning speeds.


Don't

Consistent

Consistency is a signal of a polished product. Conflicts will adversely affect the perception of quality. Consistency in writing can have many benefits, but above all instills trust in the user of a Liferay product.

  • Have a consistent message. This gives the user freedom to focus on what they’re doing, instead of reinterpreting different versions of a message.
  • Consistent sentence and phrase construction will improve overall comprehension.
  • Use the correct voice and tone to align product screens with user expectations.
  • Be consistent in your style to provide scannable visual cues.


Delete iPhone User segment?


Deleted iPhone Users segment


Do

Delete iPhone User Segment?


Awesome! The Segment iPhone User hass been removed successfully.


Don't

Conversational

Liferay’s products are a reflection of the people who work here. To improve user experience, we personify and humanize the interface through our writing. The product should be conversational and avoid “machine speak.”

  • Speak in first person on behalf of Liferay.
  • Address users in the second person.
  • Refer to 3rd parties using gender neutral pronouns.


Our support team is working to fix this issue.


Things to know

Your data will not be lost.

Your users and their data are not in risk.


Do

Liferay's support team is working to fix the offline nodes.


Things to know

Your data will not be lost.

Your users and their data are not in risk.


Don't

Something to improve? Report an issue!
Menu