diff --git a/source/_components/sensor.onewire.markdown b/source/_components/sensor.onewire.markdown
index 9f28de6ad70..73633a4900c 100644
--- a/source/_components/sensor.onewire.markdown
+++ b/source/_components/sensor.onewire.markdown
@@ -66,8 +66,6 @@ To enable One wire sensors in your installation, add the following to your `conf
 # Example configuration.yaml entry
 sensor:
   - platform: onewire
-    names:
-      some_id: your name
 ```
 
 {% configuration %}
@@ -81,3 +79,15 @@ mount_dir:
   type: string
 {% endconfiguration %}
 
+### Configuration Example
+
+When `onewire` is added to Home Assistant, it will generate an ID for the sensor. You can specify a friendly name for the sensor with the name configuration option.
+
+```yaml
+# Named sensor configuration.yaml entry
+sensor:
+  - platform: onewire
+    names:
+      GENERATED_ID: FRIENDLY_NAME
+```
+