summaryrefslogtreecommitdiff
path: root/Documentation/HumanInterfaceGuidelines/Text.md
blob: 5592317ff5f922acf958fdf2adde73310f4f647b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
# Guidelines for user interface text in SerenityOS

## Capitalization

SerenityOS employs two capitalization styles:

- Book title capitalization
- Sentence-style capitalization

### Book title capitalization

In this style, we capitalize the first letter of the first and last word,
as well as all words in between, *except* articles (a, an, the);
the seven coordinating conjunctions (for, and, nor, but, or, yet, so);
and prepositions with up to four letters (at, by, for, with, into, ...)

#### Examples:
- Create New Layer
- Copy URL
- Move to Front
- Save and Exit
- Sort by Name

#### Used for:

- Button text
- Icon labels
- Menu names
- Menu items
- Tab titles
- Window titles
- Tooltips

### Sentence-style capitalization

This style follows basic English sentence capitalization.
We capitalize the first letter of the first word, along with the first letter
of proper names, weekdays, etc.

#### Examples:
- An error occurred
- Use system defaults
- Copy the selected text
- Enable Linux compatibility hacks

#### Used for:

- Check box labels
- Group box labels
- List items
- Messages (as in message boxes)
- Radio button labels
- Status bar text
- Text box labels

## Ellipses

The ellipsis, represented by a series of three periods (...), has two special
functions in the interface:

- Eliding text
- Foreshadowing additional user input

The first occurs programmatically, but the second requires care when setting
text manually.

Control text which implies an action whose effect is incomplete pending further
user input should end in an ellipsis. Opening a new window does not in itself
justify the use of an ellipsis; the dialog must be an intermediate step toward
completing the action.

Ellipses should be used sparingly elsewhere to avoid confusion with elision.

#### Examples:
- Save As...
- Browse...
- Insert Emoji...