From e716cc23494a2e3dcf5b34fb3d4e9cf7db344c17 Mon Sep 17 00:00:00 2001
From: Matt King <a11yThinker@Gmail.com>
Date: Mon, 10 Jul 2023 14:20:37 -0700
Subject: [PATCH] Combobox Pattern: Simplify wording of description in "About
 This Pattern" section (pull #2733)

On the combobox pattern page, in the "About This Pattern" section, revises the first two paragraphs of the description of a combobox.
---
 content/patterns/combobox/combobox-pattern.html | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/content/patterns/combobox/combobox-pattern.html b/content/patterns/combobox/combobox-pattern.html
index 03776ee2a0..640e29356c 100644
--- a/content/patterns/combobox/combobox-pattern.html
+++ b/content/patterns/combobox/combobox-pattern.html
@@ -19,9 +19,12 @@ <h1>Combobox Pattern</h1>
       <section id="about">
         <h2>About This Pattern</h2>
         <p>
-          A <a href="#combobox" class="role-reference">combobox</a> is an input widget with an associated popup that enables users to select a value for the combobox from a collection of possible values.
-          In some implementations, the popup presents allowed values, while in other implementations, the popup presents suggested values, and users may either select one of the suggestions or type a value.
+          A <a href="#combobox" class="role-reference">combobox</a> is an input widget that has an associated popup.
+          The popup enables users to choose a value for the input from a collection.
           The popup may be a <a href="../listbox/listbox-pattern.html">listbox</a>, <a href="../grid/grid-pattern.html">grid</a>, <a href="../treeview/treeview-pattern.html">tree</a>, or <a href="../dialog-modal/dialog-modal-pattern.html">dialog.</a>
+        </p>
+        <p>
+          In some implementations, the popup presents allowed values, while in other implementations, the popup presents suggested values.
           Many implementations also include a third optional element -- a graphical <q>Open</q> button adjacent to the combobox, which indicates availability of the popup.
           Activating the <q>Open</q> button displays the popup if suggestions are available.
         </p>
@@ -29,7 +32,7 @@ <h2>About This Pattern</h2>
           The combobox pattern supports several optional behaviors.
           The one that most shapes interaction is text input.
           Some comboboxes allow users to type and edit text in the combobox and others do not.
-          If a combobox does not support text input, it is referred to as select-only, meaning the only way users can set a value is by selecting a value in the popup.
+          If a combobox does not support text input, it is referred to as select-only, meaning the only way users can set its value is by selecting a value in the popup.
           For example, in some browsers, an HTML <code>select</code> element with <code>size="1"</code> is presented to assistive technologies as a combobox.
           Alternatively, if a combobox supports text input, it is referred to as editable.
           An editable combobox may either allow users to input any arbitrary value, or it may restrict its value to a discrete set of allowed values, in which case typing input serves to filter suggestions presented in the popup.