Clarify nest device trigger documentation

[allenporter]

Proposed change

Clarify documentation around device automations, based on threads in community forums.

I see regular confusion on topics such as:

• Are automations supported?
  • ✔️ Added pointer at the top
• Where are they?
  • ✔️ Added screenshots
• Confusion about events vs device triggers
  • ✔️ Put more emphasis on the device triggers, though still kept details on internal events and the SDM API

Type of change

• Spelling, grammar or other readability improvements (current branch).
• Adjusted missing or incorrect information in the current documentation (current branch).
• Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • I've opened up a PR to add logo's and icons in Brands repository.
• Added documentation for a new feature I'm adding to Home Assistant (next branch).
• Removed stale or deprecated documentation.

Additional information

• Link to parent pull request in the codebase:
• Link to parent pull request in the Brands repository:
• This PR fixes or closes issue:

Checklist

• This PR uses the correct branch, based on one of the following:
  • I made a change to the existing documentation and used the current branch.
  • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
• The documentation follows the Home Assistant documentation standards.

[frenck]

Small review comments

[frenck]

This list should contain device types supported. A TOC is provided on the right of each page, we don't need to create one.

[allenporter]

One thing I'm confused about is that the text says "device types" but then it lists some entities, which seemed inconsistent. I was playing around with combining this with the list of supported devices in the overview, but it got a bit messy. I'll just revert this all for now.

[frenck]

Well, since we now have a TOC, we actually should start removing these all IMHO.
Instead, I can extract this data from the core source and add it to the frontmatter and show it automatically.

Future improvements 😉

[allenporter]

This is ready for another look, post holiday bump.

[frenck]

Thanks, @allenporter 👍