From 3789aa95d4bf10f23f93939a27dac2279626ec97 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen <paulus@paulusschoutsen.nl>
Date: Sat, 16 Jun 2018 22:49:23 -0400
Subject: [PATCH] Update docs

---
 docs/frontend_experiment_index.md | 42 ++++++++++++++++++++++++++++---
 1 file changed, 39 insertions(+), 3 deletions(-)

diff --git a/docs/frontend_experiment_index.md b/docs/frontend_experiment_index.md
index 7432b7de..3fd630f7 100644
--- a/docs/frontend_experiment_index.md
+++ b/docs/frontend_experiment_index.md
@@ -12,21 +12,57 @@ The current approach will look at your groups and entities and will sort them on
 Create `<config>/experimental-ui.yaml`:
 
 ```yaml
+title: My Awesome Home
 views:
-- cards:
+  # The name of a view will be used as tab title.
+  # Might be used for other things in the future.
+- name: Example
+  # Each view can have a different theme applied.
+  theme: dark-mode
+  # The cards to show on this view.
+  cards:
+    # The entities card will take a list of entities and show their state.
   - type: entities
+    # Title of the entities card
     title: Example
+    # The entities here will be shown in the same order as specified.
     entities:
       - input_boolean.switch_ac_kitchen
       - input_boolean.switch_ac_livingroom
       - input_boolean.switch_tv
+
+    # The filter card will filter available entities for certain criteria
+    # and render it as type 'entities'.
   - type: entity-filter
+    # Filter criteria. They are all optional.
     filter:
       domain: input_boolean
       state: 'on'
+    # This config will be passed to the card rendering the filter results
     card_config:
       title: Input booleans that are on
-  theme: dark-mode
+
+    # Use the HTML imports to load custom UI to render cards.
+    # Custom UI needs to be custom element that takes in `config` and `hass`
+  - type: 'custom:my-custom-ui'
+    # Any value here is made available to your element via the `config` property.
+    some: value
+
+  # Specify a tab_icon if you want the view tab to be an icon.
+- tab_icon: mdi:home-assistant
+  # Name of the view. Will be used as the tooltip for tab icon
+  name: Second view
+  cards:
+  - type: entities
+    title: Lots of Kitchen AC
+    entities:
+        # It is totally possible to render duplicates.
+      - input_boolean.switch_ac_kitchen
+      - input_boolean.switch_ac_kitchen
+      - input_boolean.switch_ac_kitchen
+      - input_boolean.switch_ac_kitchen
+      - input_boolean.switch_ac_kitchen
+      - input_boolean.switch_ac_kitchen
 ```
 
 Add to your `configuration.yaml`:
@@ -51,4 +87,4 @@ This is the very very early version aimed at gathering feedback. Discussion and
 
 **Home Assistant 0.72**
 
-- Initial release
+- Initial release supporting title, defining views with a name, tab icon, theme and cards. Supported cards are entities, entity-filter and custom.