diff --git a/atom.xml b/atom.xml index 6ac82bb8c8..17fd8e94e3 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@
Components that interact with devices are called “Entity Components”. They are structured in core- and platform logic. This allows the same logic to handle a light to be used by different brands.
+Components that interact with devices are called “Entity Components.” They are structured in core and platform logic, which means different brands can use the same logic to handle a light.
-For example, the built-in switch
component consists of various platforms in homeassistant/components/switch/
. The file __init__.py
contains the core logic of all platform and the vendor_name.py
files only the relevant platform code.
For example, the built-in switch
component consists of various platforms in homeassistant/components/switch/
. The file __init__.py
contains the core logic of all platforms and the vendor_name.py
files contain only the relevant platform code.
If you are planning to add support for a new type of device to an existing component, you can get away with only writing platform logic. Have a look at how the component works with other platforms and create a similar file for the platform that you would like to add:
+If you’re planning to add support for a new type of device to an existing component, you can get away with only writing platform logic. Have a look at how the component works with other platforms and create a similar file for the platform that you want to add:
One of the rules for Home Assistant is that platform logic should never interface directly with devices but use a third-party Python 3 library to do so. This way Home Assistant is able to share code with the Python community and we can keep the project maintainable.
+One Home Assistant rule is that platform logic should never interface directly with devices. Instead, use a third-party Python 3 library. This way, Home Assistant can share code with the Python community and keep the project maintainable.
-To integrate the third-party library you create an Entity class for your device. Entities are Home Assistant’s representation of lights, switches, sensors, etc. and are derived from the Entity Abstract Class. This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and much more.
+To integrate the third-party library, create an Entity class for your device. Entities are Home Assistant’s representations of lights, switches, sensors, etc. and are derived from the Entity Abstract Class. This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and much more.
Platforms can specify dependencies and requirements the same way as a component does:
+Platforms can specify dependencies and requirements the same way as components:
REQUIREMENTS = ['some-package==2.0.0', 'some-other-package==2.5.0']
DEPENDENCIES = ['mqtt']
diff --git a/sitemap.xml b/sitemap.xml
index 8d765a2c1c..fa0c3a8d45 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2113,62 +2113,62 @@
https://home-assistant.io/demo/frontend.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/index.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-dev-event.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-dev-info.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-dev-service.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-dev-state.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-dev-template.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-history.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-iframe.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-logbook.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/demo/panels/ha-panel-map.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/googlef4f3693c209fe788.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00
https://home-assistant.io/static/mdi-demo.html
-2016-10-05T14:08:39+00:00
+2016-10-05T22:04:11+00:00