IntelliJ Platform Plugin SDK Help

Punctuation

Use the following rules for labels and description texts in IntelliJ user interfaces. For punctuation in numbers and times, see Data formats.

Ellipsis

End an action name with an ellipsis if it opens a dialog where input is required or possible. An ellipsis helps users understand if an action is immediate, or additional interaction is to follow.

This rule applies to actions in the following controls: button, link, menu item.

Examples:

Save All

Build Project

Happens immediately, no ellipsis

Import Settings…

Export to HTML…

Opens dialogs that require input

Project Structure…

Opens a complex dialog where input is not required but possible

Tip of the Day

About IntelliJ IDEA

Opens dialogs that just show information, no input is either required or possible

Use an ellipsis at the end of a truncated text if there is no scrollbar and this is not a table column, see truncation in table columns. Provide a way to show the full text, for example, expand the control or show a tooltip on hover.

2 01 truncated text
A notification can be expanded to show the full text.

Use an ellipsis with verbs describing an ongoing process, for example, Searching… See more examples in Progress text.

Use the ellipsis character … (U+2026 in Unicode). Do not use three separate "dot" characters.

Period

Do not put a period at the end of a single sentence, even if it is a complete sentence.

1 01 no period 1
1 01 no period 2

If a text consists of several sentences, put a period after each sentence. 1 02 periods several sentences

Do not put a period at the end of an IDE action.

1 03 periods action
The empty text consists of two sentences, but the second one is an IDE action, so it should not have a period.

Note that links that are not IDE actions can have a period in the end.

1 04 period navigation link

Comma

Use a comma:

Before a conjunction in a list of three or more items (the Oxford or serial comma).

Border for a text field, combo box, or spinner

Between symbols in series.

Use the following characters: &, $, ., and *

Colon

Use a colon after labels for inputs and radio button / checkbox groups.

Label nounRadio example

Do not use a colon if a label and text inside the input element make a phrase.

Label sentence

Contractions

Generally, do not use contractions.

Path can’t be found → Path cannot be found

Use contractions only if the action name has 4 and more words, and the contracted word does not affect the meaning significantly.

What’s New in IntelliJ IDEA

Don’t or Do not:

  • Always contract in the phrase Don’t [some verb] again. The phrase is common, and the meaning is easily recognized.

    3 01 dont ask again
  • In other cases, do not contract. The full form reduces chances that the relevant meaning might be missed.

Don’t send → Do not send

Do not save, forget passwords after restart

Quotation marks

Use single quotation marks by default.

Indexing library 'KotlinJavaRuntime'
Error parsing '.mvn/maven.config'
Add 'root=true' to the beginning of the file
Show 'Scratches and Consoles' in the Project view

Do not use quotation marks for keyboard key names.

Type an expression and press 'Enter' → press Enter

Do not use double quotation marks.

Question marks

Use only in alerts when asking for confirmation.

A file with this name already exists. Do you want to overwrite it?

Avoid in other cases.

Forgot password? → Remind password

Exclamation points

Do not use. Exclamation points can cause the sentence tone to be interpreted as aggressive, condescending, or overly informal.

Last modified: 17 May 2024