From 5015c20ed316af02549913ced4997e4654264e1a Mon Sep 17 00:00:00 2001
From: "Daniel D. Beck" <daniel@ddbeck.com>
Date: Thu, 14 Nov 2024 19:26:46 +0100
Subject: [PATCH 1/3] Revise `<input>` type descriptions

---
 features/button.yml            | 2 +-
 features/input-button.yml      | 2 +-
 features/input-checkbox.yml    | 2 +-
 features/input-color.yml       | 2 +-
 features/input-date-time.yml   | 2 +-
 features/input-file.yml        | 2 +-
 features/input-hidden.yml      | 2 +-
 features/input-image.yml       | 2 +-
 features/input-number.yml      | 2 +-
 features/input-password.yml    | 2 +-
 features/input-radio.yml       | 2 +-
 features/input-range.yml       | 2 +-
 features/input-reset.yml       | 2 +-
 features/input-submit.yml      | 2 +-
 features/input.yml             | 2 +-
 features/search-input-type.yml | 2 +-
 16 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/features/button.yml b/features/button.yml
index 464c3778ff7..563a076226b 100644
--- a/features/button.yml
+++ b/features/button.yml
@@ -1,5 +1,5 @@
 name: <button>
-description: The `<button>` element is an interactive element activated by a user gesture that performs an action such as submitting a form, or opening a dialog.
+description: The `<button>` HTML element represents a pushbutton that triggers some action, such as submitting a form or opening a dialog, styled as a labeled rectangular box by default.
 spec: https://html.spec.whatwg.org/multipage/form-elements.html#the-button-element
 group:
   - forms
diff --git a/features/input-button.yml b/features/input-button.yml
index 268d8b2f2bc..dff3f9607d4 100644
--- a/features/input-button.yml
+++ b/features/input-button.yml
@@ -1,5 +1,5 @@
 name: '<input type="button">'
-description: The `<input type="button">` HTML element represents a button with programmable behavior, and which is inert by default.
+description: The `<input type="button">` HTML element represents a pushbutton that triggers some action, such as submitting a form or opening a dialog, styled as a labeled rectangular box by default. Not to be confused with the `<button>` elment, which contains HTML content.
 spec: https://html.spec.whatwg.org/multipage/input.html#button-state-(type=button)
 group:
   - forms
diff --git a/features/input-checkbox.yml b/features/input-checkbox.yml
index aff736f367a..18fc942f769 100644
--- a/features/input-checkbox.yml
+++ b/features/input-checkbox.yml
@@ -1,5 +1,5 @@
 name: '<input type="checkbox">'
-description: The `<input type="checkbox">` HTML element represents a checkable box.
+description: The `<input type="checkbox">` HTML element represents a tickable box with two states, checked and unchecked.
 spec: https://html.spec.whatwg.org/multipage/input.html#checkbox-state-(type=checkbox)
 group:
   - forms
diff --git a/features/input-color.yml b/features/input-color.yml
index 4c6e3146aee..4d01ed950f8 100644
--- a/features/input-color.yml
+++ b/features/input-color.yml
@@ -1,5 +1,5 @@
 name: '<input type="color">'
-description: The `<input type="color">` HTML element displays a color picker, from which users can choose a color.
+description: The `<input type="color">` HTML element shows a color picker from which users can choose a color value.
 spec: https://html.spec.whatwg.org/multipage/input.html#color-state-(type=color)
 group:
   - forms
diff --git a/features/input-date-time.yml b/features/input-date-time.yml
index 65815df28ae..4fbd375d2cb 100644
--- a/features/input-date-time.yml
+++ b/features/input-date-time.yml
@@ -1,5 +1,5 @@
 name: Date and time <input> types
-description: The `<input type="date">` and `<input type="time">` HTML elements represent date and time pickers in a form.
+description: The `<input type="date">` and `<input type="time">` HTML elements show date and time pickers.
 spec: https://html.spec.whatwg.org/multipage/input.html#date-state-(type=date)
 group:
   - forms
diff --git a/features/input-file.yml b/features/input-file.yml
index 1e5b7ce7c13..1f7b6f56a44 100644
--- a/features/input-file.yml
+++ b/features/input-file.yml
@@ -1,5 +1,5 @@
 name: '<input type="file">'
-description: The `<input type="file">` HTML element represents a field used to upload a file.
+description: The `<input type="file">` HTML element shows a file picker from which users can choose a file to upload with the form.
 spec: https://html.spec.whatwg.org/multipage/input.html#file-upload-state-(type=file)
 group:
   - forms
diff --git a/features/input-hidden.yml b/features/input-hidden.yml
index 77c8c9175d8..bbb91e78268 100644
--- a/features/input-hidden.yml
+++ b/features/input-hidden.yml
@@ -1,5 +1,5 @@
 name: '<input type="hidden">'
-description: The `<input type="hidden">` HTML element represents a form field that is not displayed visually on the page.
+description: The `<input type="hidden">` HTML element represents a form field that is not shown visually but is still included in the form submission.
 spec: https://html.spec.whatwg.org/multipage/input.html#hidden-state-(type=hidden)
 group:
   - forms
diff --git a/features/input-image.yml b/features/input-image.yml
index 17fe0c12b1d..3bae62ae4b0 100644
--- a/features/input-image.yml
+++ b/features/input-image.yml
@@ -1,5 +1,5 @@
 name: '<input type="image">'
-description: The `<input type="image">` HTML element represents an image which can be used to submit a form.
+description: The `<input type="image">` HTML element is an image that can be used to submit a form, like the `<input type="submit">` element.
 spec: https://html.spec.whatwg.org/multipage/input.html#image-button-state-(type=image)
 group:
   - forms
diff --git a/features/input-number.yml b/features/input-number.yml
index 1bde460c86d..fcc02cd1828 100644
--- a/features/input-number.yml
+++ b/features/input-number.yml
@@ -1,5 +1,5 @@
 name: '<input type="number">'
-description: The `<input type="number">` HTML element restricts input in the field to numeric data.
+description: The `<input type="number">` HTML element represents numeric input data.
 spec: https://html.spec.whatwg.org/multipage/input.html#number-state-(type=number)
 group:
   - forms
diff --git a/features/input-password.yml b/features/input-password.yml
index 9728f2a311f..4f564164dd6 100644
--- a/features/input-password.yml
+++ b/features/input-password.yml
@@ -1,5 +1,5 @@
 name: '<input type="password">'
-description: The `<input type="password">` HTML element represents a field for users to enter passwords while ensuring the typed characters are hidden from view, typically replaced by asterisks.
+description: The `<input type="password">` HTML element represents a field for users to enter a password. The password is hidden from view, typically replaced by dots or asterisks.
 spec: https://html.spec.whatwg.org/multipage/input.html#password-state-(type=password)
 group:
   - forms
diff --git a/features/input-radio.yml b/features/input-radio.yml
index 54a02b74e03..2b23a436780 100644
--- a/features/input-radio.yml
+++ b/features/input-radio.yml
@@ -1,5 +1,5 @@
 name: '<input type="radio">'
-description: The `<input type="radio">` HTML element represents a button which can be selected to the exclusion of others, or as one of multiple selections in a group.
+description: The `<input type="radio">` HTML element represents one button in a group such that only one can be chosen at a time.
 spec: https://html.spec.whatwg.org/multipage/input.html#radio-button-state-(type=radio)
 group:
   - forms
diff --git a/features/input-range.yml b/features/input-range.yml
index 9ed2e394cfe..3bb64fc7e81 100644
--- a/features/input-range.yml
+++ b/features/input-range.yml
@@ -1,5 +1,5 @@
 name: '<input type="range">'
-description: The `<input type="range">` element allows the user to choose a value using a slider widget.
+description: The `<input type="range">` element represents a slider for choosing an inexact value between a minimum and maximum value.
 spec: https://html.spec.whatwg.org/multipage/input.html#range-state-(type=range)
 group:
   - forms
diff --git a/features/input-reset.yml b/features/input-reset.yml
index db3ac1b91ed..6bd3396bc23 100644
--- a/features/input-reset.yml
+++ b/features/input-reset.yml
@@ -1,5 +1,5 @@
 name: '<input type="reset">'
-description: The `<input type="reset">` HTML element is rendered as a button, and resets all inputs in the form to their initial values.
+description: The `<input type="reset">` HTML element represents a pushbutton that sets all form fields to their initial values.
 spec: https://html.spec.whatwg.org/multipage/input.html#reset-button-state-(type=reset)
 group:
   - forms
diff --git a/features/input-submit.yml b/features/input-submit.yml
index e11e55685b6..d7d13f98e9d 100644
--- a/features/input-submit.yml
+++ b/features/input-submit.yml
@@ -1,5 +1,5 @@
 name: '<input type="submit">'
-description: The `<input type="submit">` HTML element submits its associated `<form>`.
+description: The `<input type="submit">` HTML element sends the data from its associated `<form>` to a server.
 spec: https://html.spec.whatwg.org/multipage/input.html#submit-button-state-(type=submit)
 group:
   - forms
diff --git a/features/input.yml b/features/input.yml
index 3ec8b5345b7..65e341d4d7a 100644
--- a/features/input.yml
+++ b/features/input.yml
@@ -1,5 +1,5 @@
 name: <input>
-description: The `<input type="text">` HTML element allows the user to input information into a form. By default, an `<input>` element is a text input.
+description: The `<input type="text">` HTML element allows the user to enter information into a form. By default, an `<input>` element is a text input.
 spec: https://html.spec.whatwg.org/multipage/input.html#the-input-element
 group:
   - forms
diff --git a/features/search-input-type.yml b/features/search-input-type.yml
index 8f630412272..b1949c1811c 100644
--- a/features/search-input-type.yml
+++ b/features/search-input-type.yml
@@ -1,5 +1,5 @@
 name: '<input type="search">'
-description: The `<input>` HTML element with the `type="search"` attribute represents a text field for search queries, which might be styled differently by the browser.
+description: The `<input type="search">` HTML element represents a text field for search queries.
 spec: https://html.spec.whatwg.org/multipage/input.html#text-(type=text)-state-and-search-state-(type=search)
 group: forms
 caniuse: input-search

From db2fdf2266cdf24e5fc10dc06daf597f981f7b8a Mon Sep 17 00:00:00 2001
From: "Daniel D. Beck" <daniel@ddbeck.com>
Date: Mon, 18 Nov 2024 16:47:42 +0100
Subject: [PATCH 2/3] Withdraw pushbutton terminology

---
 features/button.yml       | 2 +-
 features/input-button.yml | 2 +-
 features/input-reset.yml  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/features/button.yml b/features/button.yml
index 563a076226b..abbfbb7ebc3 100644
--- a/features/button.yml
+++ b/features/button.yml
@@ -1,5 +1,5 @@
 name: <button>
-description: The `<button>` HTML element represents a pushbutton that triggers some action, such as submitting a form or opening a dialog, styled as a labeled rectangular box by default.
+description: The `<button>` HTML element represents a button that triggers some action, such as submitting a form or opening a dialog, styled as a labeled rectangular box by default.
 spec: https://html.spec.whatwg.org/multipage/form-elements.html#the-button-element
 group:
   - forms
diff --git a/features/input-button.yml b/features/input-button.yml
index dff3f9607d4..ca27dee7bb7 100644
--- a/features/input-button.yml
+++ b/features/input-button.yml
@@ -1,5 +1,5 @@
 name: '<input type="button">'
-description: The `<input type="button">` HTML element represents a pushbutton that triggers some action, such as submitting a form or opening a dialog, styled as a labeled rectangular box by default. Not to be confused with the `<button>` elment, which contains HTML content.
+description: The `<input type="button">` HTML element represents a button that triggers some action, such as submitting a form or opening a dialog, styled as a labeled rectangular box by default. Not to be confused with the `<button>` elment, which contains HTML content.
 spec: https://html.spec.whatwg.org/multipage/input.html#button-state-(type=button)
 group:
   - forms
diff --git a/features/input-reset.yml b/features/input-reset.yml
index 6bd3396bc23..aa3118a963a 100644
--- a/features/input-reset.yml
+++ b/features/input-reset.yml
@@ -1,5 +1,5 @@
 name: '<input type="reset">'
-description: The `<input type="reset">` HTML element represents a pushbutton that sets all form fields to their initial values.
+description: The `<input type="reset">` HTML element represents a button that sets all form fields to their initial values.
 spec: https://html.spec.whatwg.org/multipage/input.html#reset-button-state-(type=reset)
 group:
   - forms

From 418c452f0cb347638f83aa8b21ac79f756f357e5 Mon Sep 17 00:00:00 2001
From: "Daniel D. Beck" <daniel@ddbeck.com>
Date: Tue, 19 Nov 2024 14:29:37 +0100
Subject: [PATCH 3/3] Apply suggestions from code review

---
 features/input-submit.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/features/input-submit.yml b/features/input-submit.yml
index d7d13f98e9d..5a53cb37400 100644
--- a/features/input-submit.yml
+++ b/features/input-submit.yml
@@ -1,5 +1,5 @@
 name: '<input type="submit">'
-description: The `<input type="submit">` HTML element sends the data from its associated `<form>` to a server.
+description: The `<input type="submit">` HTML element represents a button that triggers an action on its associated `<form>`, such as sending the form data to a server.
 spec: https://html.spec.whatwg.org/multipage/input.html#submit-button-state-(type=submit)
 group:
   - forms