From 931ceab4facb2515ae5bfbd9565803786384411e Mon Sep 17 00:00:00 2001
From: Martin Hjelmare <marhje52@kth.se>
Date: Sun, 10 Feb 2019 14:11:35 +0100
Subject: [PATCH] Add person component (#8458)

* Add person component

* Add logo
---
 source/_components/person.markdown | 66 ++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 source/_components/person.markdown

diff --git a/source/_components/person.markdown b/source/_components/person.markdown
new file mode 100644
index 00000000000..079178bde58
--- /dev/null
+++ b/source/_components/person.markdown
@@ -0,0 +1,66 @@
+---
+layout: page
+title: "Person"
+description: "Instructions on how to setup people tracking within Home Assistant."
+date: 2019-02-05 22:36
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: home-assistant.png
+ha_category: Presence Detection
+ha_qa_scale: internal
+ha_release: 0.88
+---
+
+The person component allows to connect device tracker entities to one or more person entities. The last state update of a connected device tracker will set the state of the person. Eg if you connect your router and your owntracks device as trackers to your person, the last state update from either the router or your owntracks device will set the state of your person.
+
+## {% linkable_title Configuring the `person` component %}
+
+To get started add the following lines to your `configuration.yaml`:
+
+```yaml
+# Example configuration.yaml entry
+person:
+  - name: Ada
+    id: ada6789
+    device_trackers:
+      - device_tracker.ada
+```
+
+{% configuration %}
+  id:
+    description: A unique id of the person.
+    required: true
+    type: string
+  name:
+    description: The name of the person.
+    required: true
+    type: string
+  user_id:
+    description: The user id of the Home Assistant user account for the person.
+    required: false
+    type: string
+  device_trackers:
+    description: A list of device tracker entity ids to track. These will represent the state of the person.
+    required: false
+    type: list, string
+{% endconfiguration %}
+
+
+An extended example would look like the following sample:
+
+```yaml
+# Example configuration.yaml entry
+person:
+  - name: Ada
+    id: ada6789
+    device_trackers:
+      - device_tracker.ada
+  - name: Stacey
+    id: stacey12345
+    user_id: 12345678912345678912345678912345
+    device_trackers:
+      - device_tracker.stacey
+      - device_tracker.beacon
+```