Skip to content

Commit b5fe7df

Browse files
authored
Merge pull request home-assistant#861 from technicalpickles/link-to-source
Link to more things
2 parents d60ae6a + 9f7923e commit b5fe7df

File tree

2 files changed

+4
-4
lines changed

2 files changed

+4
-4
lines changed

source/developers/add_new_platform.markdown

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ sharing: true
99
footer: true
1010
---
1111

12-
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.
12+
Components that interact with devices are called [Entity Components](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/helpers/entity_component.py). They are structured in core- and platform logic. This allows the same logic to handle a light to be used by different brands.
1313

1414
For example, the built-in `switch` component consists of various platform in [`homeassistant/components/switch/`](https://github.com/home-assistant/home-assistant/tree/master/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.
1515

@@ -22,11 +22,11 @@ If you are planning to add support for a new type of device to an existing compo
2222

2323
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.
2424

25-
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](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/entity.py). This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and much more.
25+
To integrate the third-party library you create an [Entity class](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/helpers/entity.py) for your device. Entities are Home Assistant's representation of lights, switches, sensors, etc. and are derived from the [Entity Abstract Class](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/entity.py). This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and much more.
2626

2727
### {% linkable_title Requirements and dependencies %}
2828

29-
Platforms can specify dependencies and requirements the same way as a component does.
29+
Platforms can specify dependencies and requirements [the same way as a component does](/developers/component_deps_and_reqs):
3030

3131
```python
3232
REQUIREMENTS = ['some-package==2.0.0', 'some-other-package==2.5.0']

source/developers/architecture_components.markdown

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ We can differentiate between two different types of components within Home Assis
2222

2323
These components will track devices within a specific domain and consist of a core part and platform-specific logic. These components make their information available via the State Machine and the Event Bus. The component will also register services in the Service Registry to expose control of the devices.
2424

25-
For example, one of the built-in components is the `switch` component. This component is responsible for interaction with different types of switches.
25+
For example, one of the built-in components is the [`switch` component](/components/switch/). This component is responsible for interaction with different types of switches.
2626

2727
A platform provides support for a particular kind/brand of device. For example, a switch could use a WeMo or Orvibo platform, and a light component might interact with the Hue or LiFX platform.
2828

0 commit comments

Comments
 (0)