diff --git a/source/getting-started/devices.markdown b/source/getting-started/devices.markdown
index 99a3346eff8..93e2a0c0a6e 100644
--- a/source/getting-started/devices.markdown
+++ b/source/getting-started/devices.markdown
@@ -11,13 +11,47 @@ footer: true
 
 Home Assistant will be able to automatically discover and configure any Google Chromecasts, Netgear routers, Belkin WeMo switches, Philips Hue bridges and Sonos speakers in your network if you have [the discovery component]({{site_root}}/components/discovery/) enabled (which is by default).
 
-See the [components overview page](/components/) to find installation instructions for your devices and services.  Many components use the `sensor` platform.  Sensors need to be added into the `configuration.yaml` as `sensor:`, `sensor 2:`, `sensor 3:`, etc.  There should not be gaps in the sequence or your sensors might not load correctly.
+See the [components overview page](/components/) to find installation instructions for your devices and services. If you can't find support for your favorite device or service, [consider adding support](/developers/add_new_platform/).
 
-<p class='note'>
-Most components that support multiple entries within the <code>configuration.yaml</code> follow the <code>component:</code>, <code>component 2:</code> format.
-</p>
+Usually every entity needs its own entry in the `configuration.yaml` file. There are two kind of styles for multiple entries:
 
-If you can't find support for your favorite device or service, [consider adding support](/developers/add_new_platform/)
+#### {% linkable_title Style 1 %}
+
+Collect every entity under the "parent". 
+
+```yaml
+sensor:
+  - platform: mqtt
+    state_topic: "home/bedroom/temperature"
+    name: "MQTT Sensor 1"
+  - platform: mqtt
+    state_topic: "home/bedroom/temperature"
+    name: "MQTT Sensor 2"
+  - platform: rest
+    resource: http://IP_ADDRESS/ENDPOINT
+
+switch:
+  - platform: vera
+```
+
+#### {% linkable_title Style 2 %}
+
+If you prefer to place your entries somewhere in the `configuration.yaml` file then you just choose this style. There should not be gaps in the sequence when you use numbers or your entities might not load correctly. Instead of numbers you are free to use strings (like `media_player livingroom:` or `media_player kitchen:`) to differentiate the entries as long as the appended strings are unique.
+
+```yaml
+media_player 1:
+  platform: mpd
+  server: IP_ADDRESS
+
+media_player 2:
+  platform: plex
+
+camera:
+  platform: generic
+
+media_player 3:
+  platform: sonos
+```
 
 ### {% linkable_title Grouping devices %}