jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-21 16:27:19 +00:00
Code Issues Packages Projects Releases Wiki Activity

2024.12: Finish IQS

Browse Source
This commit is contained in:
Franck Nijhof 2024-12-04 13:27:02 +01:00
parent 099b67747e
commit 48e24945f9
No known key found for this signature in database
GPG Key ID: D62583BA8AB11CA3
1 changed files with 45 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
source/_posts/2024-12-04-release-202412.markdown
View File

@ -209,49 +209,63 @@ The results speak for themselves:
## Revised Integration Quality Scale ## Revised Integration Quality Scale
The Integration Quality Scale is a way we try to classify the "quality" of an The Integration Quality Scale (IQS) is a way we classify the "quality" of an
integration. It is a way to give users an idea of what to expect from an integration. It gives users an idea of what to expect from an integration.
integration. You might have noticed our Integration Quality Scale indicator You might have noticed our IQS indicator listed on
listed on each integration documentation page. [each integration documentation page].
The scale was originally introduced in 2018?, and back then, was more aimed The scale was initially introduced in 2018 and aimed more at the technical
at the technical side and code of an integration. Over the years, it didn't side and code of an integration back then. Over the years, it didn't
really evolve with the rest of Home Assistant and the community. really evolve with the rest of Home Assistant and the general expectations of
our community. It was time for a change!
The last few months, we have worked with the community to revise and improve Over the last few months, we have worked with the community to revise and
the Integration Quality Scale. Involving not just our community developers, improve the scale. Involving not just our community developers, but also
but also documentation writers, user experience designers, and everyone else documentation writers, user experience designers, and anyone interested
in the community who wanted to join in. in the community.
As a result, the new Integration Quality Scale is not just focussed on the As a result, the new Integration Quality Scale is not just focused on the code
code, but even more on the overall user-experience it brings. It is now a but even more on the overall user experience. It is now a more holistic view
more holistic view on the integration, and we hope it will help everyone of the integration, and we hope it will help everyone make better decisions
to make better decisions on what to use in their homes. about what to use in their homes.
![The integration quality scale is also shown in the Home Assistant UI now](/images/blog/2024-12/quality-scale.jpeg) <img class="no-shadow" alt="The integration quality scale is also shown in the Home Assistant UI now. The image shows the HomeWizard Energy integration scoring platinum on the new integration quality scale." src="/images/blog/2024-12/integration-quality-scale.png" />
We now have a total of 4 scaled tiers: We now have a total of 4 scaled tiers:
- **🥉 Bronze**: The new minimum set of requirements we set for integrations. - **🥉 [Bronze](/docs/quality_scale/#-bronze)**:
- **🥈 Silver**: Ensuring reliability and robustness of integrations. The new minimum set of requirements we've set for new integrations.
- **🥇 Gold**: Ensuring a gold standard user-experience including documentation. - **🥈 [Silver](/docs/quality_scale/#-silver)**:
- **🏆 Platinum**: The epitome of quality, surpreme code quality, and an optimal performance and efficiency. Ensuring reliability and robustness of integrations.
- **🥇 [Gold](/docs/quality_scale/#-gold)**:
Ensuring a gold standard user experience, including documentation.
- **🏆 [Platinum](/docs/quality_scale/#-platinum)**:
The epitome of quality, supreme code quality, and optimal performance.
We also have four additional (non-scaled) special tiers: **❓ No score**, We also have four additional (non-scaled) special tiers:
**🏠 Internal**, **💾 Legacy**, and **📦 Custom**.
- **❓&nbsp;[No&nbsp;score](/docs/quality_scale/#-no-score)**:
For integrations that are not yet scored against the new scale.
- **🏠&nbsp;[Internal](/docs/quality_scale/#-internal)**
For integrations Home Assistant itself uses, like the automation engine.
- **💾&nbsp;[Legacy](/docs/quality_scale/#-legacy)**
For older integrations that can't be set up through the UI.
- **📦&nbsp;[Custom](/docs/quality_scale/#-custom)**
For custom integrations, as we can't score those.
You can read all about these tiers, what they have been designed for, and a You can read all about these tiers, what they have been designed for, and a
summary of their characteristics in our dedicated summary of their characteristics on our dedicated
[Integration Quality Scale page](/docs/quality_scale/). [Integration Quality Scale page].
With the new scale in place, we will be reevaluating all existing integrations We sincerely hope this new scale, will not just help our users, but also our
and updating their quality scale accordingly. This will be an ongoing process community developers to understand what is expected by providing a clear path
and will take some time to complete. oto improving their integrations. To help with that, we have now
[extensively documented every rule and requirement for each tier in our
developer documentation].
We hope this new scale will also help our community developers to understand [each integration documentation page]: /integration/homewizard
what is expected from them, and provide a clear path on how to improve their [Integration Quality Scale page]: /docs/quality_scale/
integrations. We therefore have now [extensively documented every single rule [extensively documented every rule and requirement for each tier in our developer documentation]: https://developers.home-assistant.io/docs/core/integration-quality-scale/#integration-quality-scale-rules
and requirement for each tier in our developer documentation](https://developers.home-assistant.io/docs/core/integration-quality-scale/#integration-quality-scale-rules).
## Integrations ## Integrations