From 3bf5d2045faa29a993db13bc67a89d0322bd3124 Mon Sep 17 00:00:00 2001
From: DubhAd <DubhAd@users.noreply.github.com>
Date: Wed, 10 Oct 2018 11:04:15 +0100
Subject: [PATCH] Clarity update (#6657)

As somebody pointed out on the forum, using different examples adds confusion. Updated both styles to use the same contents, so it's clearer what's going on.
---
 source/_docs/configuration/devices.markdown | 32 ++++++++++++++-------
 1 file changed, 21 insertions(+), 11 deletions(-)

diff --git a/source/_docs/configuration/devices.markdown b/source/_docs/configuration/devices.markdown
index 43706169c3a..631dd12d03c 100644
--- a/source/_docs/configuration/devices.markdown
+++ b/source/_docs/configuration/devices.markdown
@@ -33,9 +33,12 @@ sensor:
     name: "MQTT Sensor 2"
   - platform: rest
     resource: http://IP_ADDRESS/ENDPOINT
+    name: "Weather"
 
 switch:
   - platform: vera
+  - platform: tplink
+    host: IP_ADDRESS
 ```
 
 ## {% linkable_title Style 2: List each device separately %}
@@ -43,19 +46,27 @@ switch:
 You need to append numbers or strings to differentiate the entries, as in the example below. The appended number or string must be unique.
 
 ```yaml
-media_player livingroom:
-  platform: mpd
-  server: IP_ADDRESS
+sensor bedroom:
+  platform: mqtt
+  state_topic: "home/bedroom/temperature"
+  name: "MQTT Sensor 1"
 
-media_player kitchen:
-  platform: plex
+sensor kitchen:
+  platform: mqtt
+  state_topic: "home/kitchen/temperature"
+  name: "MQTT Sensor 2"
 
-camera 1:
-  platform: generic
+sensor weather:
+  platform: rest
+  resource: http://IP_ADDRESS/ENDPOINT
+  name: "Weather"
 
-camera 2:
-  platform: mjpeg
-```
+switch 1:
+  platform: vera
+
+switch 2:
+  platform: tplink
+  host: IP_ADDRESS```
 
 ## {% linkable_title Grouping devices %}
 
@@ -74,4 +85,3 @@ group:
 ```
 
 For more details please check the [Group](/components/group/) page.
-