From 1e4ddc17afcd06de82310bcced6fe3a820a84ab8 Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@koston.org>
Date: Tue, 15 Apr 2025 10:27:45 -1000
Subject: [PATCH] add data descriptions

---
 homeassistant/components/esphome/strings.json | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/homeassistant/components/esphome/strings.json b/homeassistant/components/esphome/strings.json
index 8c20fb4e95a..1725f918237 100644
--- a/homeassistant/components/esphome/strings.json
+++ b/homeassistant/components/esphome/strings.json
@@ -23,24 +23,37 @@
           "host": "[%key:common::config_flow::data::host%]",
           "port": "[%key:common::config_flow::data::port%]"
         },
+        "data_description": {
+          "host": "IP address or hostname of the ESPHome device",
+          "port": "Port that the native API is running on"
+        },
         "description": "Please enter connection settings of your ESPHome device."
       },
       "authenticate": {
         "data": {
           "password": "[%key:common::config_flow::data::password%]"
         },
+        "data_description": {
+          "password": "Password. Passwords are deprecated and will be removed in a future version. Please use an encryption key instead."
+        },
         "description": "Please enter the password you set in your configuration for {name}."
       },
       "encryption_key": {
         "data": {
           "noise_psk": "Encryption key"
         },
+        "data_description": {
+          "noise_psk": "Encryption key. This is used to encrypt the connection between Home Assistant and the ESPHome device. You can find this in the api: section of your ESPHome configuration if it is enabled."
+        },
         "description": "Please enter the encryption key for {name}. You can find it in the ESPHome Dashboard or in your device configuration."
       },
       "reauth_confirm": {
         "data": {
           "noise_psk": "[%key:component::esphome::config::step::encryption_key::data::noise_psk%]"
         },
+        "data_description": {
+          "noise_psk": "[%key:component::esphome::config::step::encryption_key::data_description::noise_psk%]"
+        },
         "description": "The ESPHome device {name} enabled transport encryption or changed the encryption key. Please enter the updated key. You can find it in the ESPHome Dashboard or in your device configuration."
       },
       "reauth_encryption_removed_confirm": {