Missing concepts in documentation

[luisrosety]

Feedback

Hi, I am starting with Home Assistant and encountering difficulties with some concepts. Your page Getting Started - Concepts & Terminology is really helpful, but I feel some important concepts are missing: Domains Services It would be beneficial to include these in your documentation for newcomers. Thank you!

URL

https://www.home-assistant.io/getting-started/concepts-terminology/

Version

2024.10.2

Additional information

No response

[j4n-e4t]

Hi @luisrosety! I totally get your point. What exactly would you find helpful to know about domains and services? I'm thinking of updating the documentation but I'm not quite sure what exactly someone like you would need?

[luisrosety]

Hi,

As a complete newcomer to Home Assistant (HA), I initially struggled to understand automations and scripting. I came across examples using terms like "domain" and "service," which took me some time to grasp. Eventually, I realized that "services" are somewhat similar to methods in object-oriented programming (OOP) — essentially, actions that an object can perform. However, the concept of "domain" is still unclear to me. I understand it might be similar to "integration," but I haven't fully figured out the difference yet.

Thank you so much for your quick response to my question, and of course, for your excellent work!

Luis Rosety

On Sun, 13 Oct 2024 at 13:17, Julian @.***> wrote:

Hi @luisrosety https://github.com/luisrosety! I totally get your point. What exactly would you find helpful to know about domains and services? I'm thinking of updating the documentation but I'm not quite sure what exactly someone like you would need?

— Reply to this email directly, view it on GitHub https://github.com/home-assistant/home-assistant.io/issues/35200#issuecomment-2408936854, or unsubscribe https://github.com/notifications/unsubscribe-auth/AIK6D23C3VVV6E4WGMTNOI3Z3JJFZAVCNFSM6AAAAABP3FHCVWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDIMBYHEZTMOBVGQ . You are receiving this because you were mentioned.Message ID: @.***>

[j4n-e4t]

@luisrosety I created a quick draft of the new page. Might taking a look? https://deploy-preview-35205--home-assistant-docs.netlify.app/getting-started/concepts-terminology/#integrations

Also, the term "service" is deprecated and was replaced with "action" last month. This hopefully makes it a bit clearer what it actually does.

[luisrosety]

Great! I think it is much clearer now. Thanks Julian Luis

On Sun, 13 Oct 2024 at 15:52, Julian @.***> wrote:

@luisrosety https://github.com/luisrosety I created a quick draft of the new page. Might taking a look?

https://deploy-preview-35205--home-assistant-docs.netlify.app/getting-started/concepts-terminology/#integrations

Also, the term "service" is deprecated and was replaced with "action" last month. This hopefully makes it a bit clearer what it actually does.

— Reply to this email directly, view it on GitHub https://github.com/home-assistant/home-assistant.io/issues/35200#issuecomment-2408988679, or unsubscribe https://github.com/notifications/unsubscribe-auth/AIK6D26LPIRELSKL725SVSLZ3J3K7AVCNFSM6AAAAABP3FHCVWVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDIMBYHE4DQNRXHE . You are receiving this because you were mentioned.Message ID: @.***>

[j4n-e4t]

It seems as if such a detailed explanation is not ment to be inside the onboarding. -> https://github.com/home-assistant/home-assistant.io/pull/35205

However, I'm glad I could help!

Have a nice day, Julian

[github-actions[bot]]

There hasn't been any activity on this issue recently. Due to the high number of incoming GitHub notifications, we have to clean some of the old issues, as many of them have already been resolved. If this issue is still relevant, please let us know by leaving a comment 👍 This issue has now has been marked as stale and will be closed if no further activity occurs. Thank you for your contributions.