diff --git a/source/_components/ads.markdown b/source/_components/ads.markdown
index 2c285b2ebbc..96adb3de43d 100644
--- a/source/_components/ads.markdown
+++ b/source/_components/ads.markdown
@@ -102,7 +102,7 @@ name:
   required: false
   type: string
 device_class:
-  description: The [type/class](/components/binary_sensor/) of the sensor to set the icon in the frontend.
+  description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: string
 {% endconfiguration %}
@@ -250,6 +250,6 @@ name:
   type: string
 device_class:
   required: false
-  description: Sets the class of the device, changing the device state and icon that is displayed on the UI (awning, blind, curtain, damper, door, garage, shade, shutter, window)
+  description: Sets the [class of the device](/components/cover/), changing the device state and icon that is displayed on the frontend.
   type: device_class
 {% endconfiguration %}
diff --git a/source/_components/binary_sensor.knx.markdown b/source/_components/binary_sensor.knx.markdown
index f144ff47952..c0351d17788 100644
--- a/source/_components/binary_sensor.knx.markdown
+++ b/source/_components/binary_sensor.knx.markdown
@@ -37,7 +37,7 @@ name:
   required: false
   type: string
 device_class:
-  description: HASS device class e.g., "motion".
+  description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: string
 significant_bit:
diff --git a/source/_components/binary_sensor.mqtt.markdown b/source/_components/binary_sensor.mqtt.markdown
index 7cccd22aa10..3aec89fc491 100644
--- a/source/_components/binary_sensor.mqtt.markdown
+++ b/source/_components/binary_sensor.mqtt.markdown
@@ -87,7 +87,7 @@ unique_id:
   required: false
   type: string
 device_class:
-  description: The [type/class](/components/binary_sensor/) of the sensor to set the icon in the frontend.
+  description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: string
 value_template:
diff --git a/source/_components/binary_sensor.rest.markdown b/source/_components/binary_sensor.rest.markdown
index 46ece211e90..b35c6ba008a 100644
--- a/source/_components/binary_sensor.rest.markdown
+++ b/source/_components/binary_sensor.rest.markdown
@@ -73,9 +73,7 @@ name:
   type: string
   default: REST Binary Sensor
 device_class:
-  description: >
-    The [type/class](/components/binary_sensor/) of
-    the sensor to set the icon in the frontend.
+  description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: string
 value_template:
diff --git a/source/_components/binary_sensor.rflink.markdown b/source/_components/binary_sensor.rflink.markdown
index bfc0979f0a8..11426bff5e6 100644
--- a/source/_components/binary_sensor.rflink.markdown
+++ b/source/_components/binary_sensor.rflink.markdown
@@ -55,7 +55,7 @@ devices:
           required: false
           type: list
         device_class:
-          description: The [type or class of the sensor](/components/binary_sensor/#device-class) to set the icon in the frontend.
+          description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
           required: false
           type: string
         off_delay:
diff --git a/source/_components/binary_sensor.rfxtrx.markdown b/source/_components/binary_sensor.rfxtrx.markdown
index 571af036e8d..1049752bb7c 100644
--- a/source/_components/binary_sensor.rfxtrx.markdown
+++ b/source/_components/binary_sensor.rfxtrx.markdown
@@ -63,7 +63,7 @@ devices:
       required: false
       type: string
     device_class:
-      description: "The [type or class of the sensor](/components/binary_sensor/) to set the icon in the frontend."
+      description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
       required: false
       type: device_class
     fire_event:
diff --git a/source/_components/binary_sensor.template.markdown b/source/_components/binary_sensor.template.markdown
index 71cb01894b7..521757fbb1e 100644
--- a/source/_components/binary_sensor.template.markdown
+++ b/source/_components/binary_sensor.template.markdown
@@ -56,7 +56,7 @@ sensors:
           required: false
           type: string, list
         device_class:
-          description: The type/class of the sensor to set the icon in the frontend.
+          description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
           required: false
           type: device_class
           default: None
diff --git a/source/_components/command_line.markdown b/source/_components/command_line.markdown
index 3fe4193a592..76fd3b8e9c4 100644
--- a/source/_components/command_line.markdown
+++ b/source/_components/command_line.markdown
@@ -31,6 +31,7 @@ binary_sensor:
 <p class='note'>
 It's highly recommended to enclose the command in single quotes `'` as it ensures all characters can be used in the command and reduces the risk of unintentional escaping. To include a single quote in a command enclosed in single quotes, double it: `''`.
 </p>
+
 {% configuration %}
 command:
   description: The action to take to get the value.
@@ -42,7 +43,7 @@ name:
   type: string
   default: "*name* from the device"
 device_class:
-  description: The [type/class](/components/binary_sensor/) of the sensor to set the icon in the frontend.
+  description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: string
 payload_on:
diff --git a/source/_components/cover.mqtt.markdown b/source/_components/cover.mqtt.markdown
index acf37e99e42..45454e6eae9 100644
--- a/source/_components/cover.mqtt.markdown
+++ b/source/_components/cover.mqtt.markdown
@@ -175,7 +175,7 @@ tilt_invert_state:
   type: boolean
   default: false
 device_class:
-  description: The [type/class](/components/cover/#device-class) of the cover to set the icon in the frontend.
+  description: Sets the [class of the device](/components/cover/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: string
 json_attributes_topic:
diff --git a/source/_components/cover.template.markdown b/source/_components/cover.template.markdown
index e4813769784..5f1188e5493 100644
--- a/source/_components/cover.template.markdown
+++ b/source/_components/cover.template.markdown
@@ -69,7 +69,7 @@ cover:
         required: false
         type: template
       device_class:
-        description: The [type/class](/components/cover/#device-class) of the cover to set the icon in the frontend.
+        description: Sets the [class of the device](/components/cover/), changing the device state and icon that is displayed on the frontend.
         required: false
         type: string
       open_cover:
diff --git a/source/_components/enocean.markdown b/source/_components/enocean.markdown
index 5cbce8bce6b..ada39a33b6e 100644
--- a/source/_components/enocean.markdown
+++ b/source/_components/enocean.markdown
@@ -102,7 +102,7 @@ name:
   type: string
   default: EnOcean binary sensor
 device_class:
-  description: The [type/class](/components/binary_sensor/) of the sensor to set the icon in the frontend.
+  description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: device_class
 {% endconfiguration %}
@@ -193,7 +193,7 @@ name:
   type: string
   default: EnOcean sensor
 device_class:
-  description: The [type/class](/components/binary_sensor/) of the sensor to set the icon in the frontend.
+  description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: device_class
   default: powersensor
diff --git a/source/_components/raspihats.markdown b/source/_components/raspihats.markdown
index fc266f4975c..bf229a3eb14 100644
--- a/source/_components/raspihats.markdown
+++ b/source/_components/raspihats.markdown
@@ -78,7 +78,7 @@ i2c_hats:
           default: false
           type: boolean
         device_class:
-          description: See device classes in [binary_sensor component](/components/binary_sensor/).
+          description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
           required: false
           default: "None"
           type: string
diff --git a/source/_components/rest.markdown b/source/_components/rest.markdown
index 835a7b98218..5536b035395 100644
--- a/source/_components/rest.markdown
+++ b/source/_components/rest.markdown
@@ -55,9 +55,7 @@ name:
   type: string
   default: REST Sensor
 device_class:
-  description: >
-    The [type/class](/components/sensor/) of
-    the sensor to set the icon in the frontend.
+  description: Sets the [class of the device](/components/sensor/), changing the device state and icon that is displayed on the frontend.
   required: false
   type: string
 value_template:
diff --git a/source/_components/trend.markdown b/source/_components/trend.markdown
index 78c22c87c7b..1d9637e8319 100644
--- a/source/_components/trend.markdown
+++ b/source/_components/trend.markdown
@@ -54,9 +54,7 @@ sensors:
       required: false
       type: string
     device_class:
-      description: >
-        The [type/class](/components/binary_sensor/#device-class) of
-        the sensor to set the icon in the frontend.
+      description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
       required: false
       type: string
     friendly_name:
diff --git a/source/_components/w800rf32.markdown b/source/_components/w800rf32.markdown
index f2b7cece328..0012c015039 100644
--- a/source/_components/w800rf32.markdown
+++ b/source/_components/w800rf32.markdown
@@ -68,7 +68,7 @@ devices:
       required: false
       type: string
     device_class:
-      description: "The [type or class of the sensor](/components/binary_sensor/) to set the icon in the frontend."
+      description: Sets the [class of the device](/components/binary_sensor/), changing the device state and icon that is displayed on the frontend.
       required: false
       type: device_class
     off_delay: