From 024360e6049c7912cc4000833ba2876fef1b2b32 Mon Sep 17 00:00:00 2001
From: thankyouverycool <66646555+thankyouverycool@users.noreply.github.com>
Date: Mon, 22 May 2023 13:07:06 -0400
Subject: [PATCH] Documentation: Add section on Ellipses to Text.md

---
 .../HumanInterfaceGuidelines/Text.md          | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/Documentation/HumanInterfaceGuidelines/Text.md b/Documentation/HumanInterfaceGuidelines/Text.md
index cd45aca7e54..5592317ff5f 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...