diff --git a/README.md b/README.md
index 88e7215a4..4222eca2c 100644
--- a/README.md
+++ b/README.md
@@ -265,11 +265,11 @@ There is other logic in the code to compensate for ramp up and whether the showe
 
 Within Home Assistant it renders as:
 
-![Home Assistant panel)](doc/ha/ha.png)
+![Home Assistant panel)](doc/home_assistant/ha.png)
 
-and the alerts on an iPhone/Android using PushBullet, PushOver or any notification service would look like:
+and the alerts on an iOS/Android device using PushBullet, PushOver or any notification service would look like:
 
-![Home Assistant iPhone notify)](doc/ha/ha_notify.jpg)
+![Home Assistant iPhone notify)](doc/home_assistant/ha_notify.jpg)
 
 You can find the .yaml configuration files under `doc/ha`. See also https://community.home-assistant.io/t/thermostat-and-boiler-controller-for-ems-based-boilers-nefit-buderus-bosch-using-esp/53382
 
diff --git a/doc/home assistant/automations.yaml b/doc/home_assistant/automations.yaml
similarity index 100%
rename from doc/home assistant/automations.yaml
rename to doc/home_assistant/automations.yaml
diff --git a/doc/home assistant/binary_sensor.yaml b/doc/home_assistant/binary_sensor.yaml
similarity index 100%
rename from doc/home assistant/binary_sensor.yaml
rename to doc/home_assistant/binary_sensor.yaml
diff --git a/doc/home assistant/climate.yaml b/doc/home_assistant/climate.yaml
similarity index 100%
rename from doc/home assistant/climate.yaml
rename to doc/home_assistant/climate.yaml
diff --git a/doc/home assistant/customize.yaml b/doc/home_assistant/customize.yaml
similarity index 100%
rename from doc/home assistant/customize.yaml
rename to doc/home_assistant/customize.yaml
diff --git a/doc/home assistant/ha.png b/doc/home_assistant/ha.png
similarity index 100%
rename from doc/home assistant/ha.png
rename to doc/home_assistant/ha.png
diff --git a/doc/home assistant/ha_notify.jpg b/doc/home_assistant/ha_notify.jpg
similarity index 100%
rename from doc/home assistant/ha_notify.jpg
rename to doc/home_assistant/ha_notify.jpg
diff --git a/doc/home assistant/input_number.yaml b/doc/home_assistant/input_number.yaml
similarity index 100%
rename from doc/home assistant/input_number.yaml
rename to doc/home_assistant/input_number.yaml
diff --git a/doc/home assistant/notify.yaml b/doc/home_assistant/notify.yaml
similarity index 100%
rename from doc/home assistant/notify.yaml
rename to doc/home_assistant/notify.yaml
diff --git a/doc/home assistant/scripts.yaml b/doc/home_assistant/scripts.yaml
similarity index 100%
rename from doc/home assistant/scripts.yaml
rename to doc/home_assistant/scripts.yaml
diff --git a/doc/home assistant/sensors.yaml b/doc/home_assistant/sensors.yaml
similarity index 100%
rename from doc/home assistant/sensors.yaml
rename to doc/home_assistant/sensors.yaml
diff --git a/doc/home assistant/switches.yaml b/doc/home_assistant/switches.yaml
similarity index 100%
rename from doc/home assistant/switches.yaml
rename to doc/home_assistant/switches.yaml
diff --git a/doc/home assistant/ui-lovelace.yaml b/doc/home_assistant/ui-lovelace.yaml
similarity index 100%
rename from doc/home assistant/ui-lovelace.yaml
rename to doc/home_assistant/ui-lovelace.yaml