Documentation: Add section on Ellipses to Text.md

1 files changed, 23 insertions, 0 deletions

diff --git a/Documentation/HumanInterfaceGuidelines/Text.md b/Documentation/HumanInterfaceGuidelines/Text.md
index cd45aca7e5..5592317ff5 100644
--- a/Documentation/HumanInterfaceGuidelines/Text.md
+++ b/Documentation/HumanInterfaceGuidelines/Text.md
@@ -52,3 +52,26 @@ of proper names, weekdays, etc.
 - 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...