Add Information to Push Notifications component (home-assistant#3502)

ajfriesen · fabaff · commit 92e9877c0e74 · 2017-10-11T08:36:01.000+02:00
* Changed to ordered list.

* Add information for HASSIO domain verifying

HASSIO Users need to place the domain verification file from google to a
specific location.
Add information about the "www" directory and how to open it in he
browser.
diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown
@@ -33,24 +33,33 @@ Configuration variables:
 
 ### {% linkable_title Getting ready for Chrome %}
 
-- Create new project at [https://console.cloud.google.com/home/dashboard](https://console.cloud.google.com/home/dashboard).
-- Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain.
-- After that, go to [https://console.firebase.google.com](https://console.firebase.google.com) and select import Google project, select the project you created.
-- Then, click the cogwheel on top left and select "Project settings".
-- Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID'.
+1. Create new project at [https://console.cloud.google.com/home/dashboard](https://console.cloud.google.com/home/dashboard).
+2. Go to [https://console.cloud.google.com/apis/credentials/domainverification](https://console.cloud.google.com/apis/credentials/domainverification) and verify your domain.
+3. After that, go to [https://console.firebase.google.com](https://console.firebase.google.com) and select import Google project, select the project you created.
+4. Then, click the cogwheel on top left and select "Project settings".
+5. Select 'Cloud Messaging' tab, listed beneath Project Credentials will be your 152 character 'Server Key' and 12 digit ID 'Sender ID'.
+
+#### {% linkable_title Verify your domain with Hass.io %}
+
+1. For verifying your domain you need to download a file in step 2.
+2. Create a dictionary named "www" in you Hass.io configuration dictionary.
+3. Place the file (something like this: google*.html) in the "www" directory.
+4. You can open it by going to **https://yourdomain/local/exact_file_name.html**
+5. Proceed with step 3.
 
 ### {% linkable_title Requirements %}
 
 The `html5` platform can only function if all of the following requirements are met:
 (On Hass.io these requirements are already met.)
 
-* You are using Chrome and/or Firefox on any desktop platform, ChromeOS, or Android.
+* You are using Chrome and/or Firefox on any desktop platform, ChromeOS or Android.
 * Your Home Assistant instance is exposed to the world.
 * If using a proxy, HTTP basic authentication must be off for registering or unregistering for push notifications. It can be re-enabled afterwards.
 * `pywebpush` must be installed. `libffi-dev`, `libpython-dev`, and `libssl-dev` must be installed prior to `pywebpush` (i.e. `pywebpush` probably won't automatically install).
 * You have configured SSL for your Home Assistant. It doesn't need to be configured in Home Assistant though, i.e. you can be running [NGINX](/ecosystem/nginx/) in front of Home Assistant and this will still work. The certificate must be trustworthy (i.e. not self signed).
 * You are willing to accept the notification permission in your browser.
 
+
 ### {% linkable_title Setting up %}
 
 Assuming you have already added the platform to your configuration:
@@ -62,6 +71,7 @@ Assuming you have already added the platform to your configuration:
 5. Assuming you accept, that's all there is to it!
 6. (Optional, but highly recommended!) Open the `html5_push_registrations.conf` file in your configuration directory. You will see a new entry for the browser you just added. Rename it from `unnamed device` to a name of your choice, which will make it easier to identify later. _Do not change anything else in this file!_ You need to restart Home Assistant after making any changes to the file.
 
+
 ### {% linkable_title Usage %}
 
 The `html5` platform accepts a standard notify payload. However, there are also some special features built in which you can control in the payload.
