docs: cover 2026.6 automation, helper, template & dashboard changes#60
docs: cover 2026.6 automation, helper, template & dashboard changes#60kingpanther13 wants to merge 2 commits into
Conversation
There was a problem hiding this comment.
Code Review
This pull request expands the Home Assistant Best Practices guide by adding a new reference document for scenes and updating existing guides with modern features up to version 2026.6, such as native zone triggers, dashboard strategies, new helpers, and template device trackers. The review feedback identifies several technical inaccuracies in the documentation, including an invalid Jinja template example for the enabled option, an obsolete entity_id field in the markdown card, and incorrect configuration fields for the template device tracker. Additionally, it recommends formatting lists as comma-separated sentences to optimize token-efficiency for LLM consumption.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
69fe4f5 to
2661b3a
Compare
Fills coverage gaps that predate 2026.6 (issue homeassistant-ai#50): automation-patterns.md - Trigger Types: zone, template, calendar, webhook, homeassistant, conversation, tag, geo_location, persistent_notification triggers; fire-an-event action note - Native Conditions: trigger condition; device-condition caveat note - New sections: Parallel Actions (vs mode: parallel), Stopping a Sequence (stop:), Variables (+ trigger_variables caveat), Capturing Action Responses (response_variable); delay: action; per-element enabled: helper-selection.md - trend, bayesian (new Probabilistic Inference section), mold_indicator - 'How Helpers Are Created': storage-collection vs config-entry-flow classification (HA mechanisms, no tool names) - TOC + decision-matrix rows dashboard-guide.md - Dashboard Strategies (+ 'Take control'); heading card; markdown card; grid_options card sizing; expanded visibility conditions (screen, etc.); typed entity/object badge form; drop stale (2024+) heading qualifier references/scenes.md (new) - Scene config shape, turn_on/create/apply/reload, snapshot-vs-script - SKILL.md Reference Files + README Skill Contents updated Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Addresses the 2026.6-specific doc issues (homeassistant-ai#55, homeassistant-ai#56, homeassistant-ai#57, homeassistant-ai#58): template-guidelines.md (homeassistant-ai#55) - Rewrite the per-domain platform:template example to the modern top-level template: form; note the legacy form was removed in 2026.6 helper-selection.md (homeassistant-ai#58) - Add the template device_tracker sub-type (2026.6) + its keys note automation-patterns.md (homeassistant-ai#57) - Native 2026.6 zone triggers/conditions (zone.entered/left/occupancy_*, zone.in_zone/not_in_zone/occupancy_*), options:/target:/behavior: serialization (each/all), Labs-gated, any-zone; classic zone trigger/ condition + state triggers kept as the stable fallback - Soften the 'no new YAML syntax' claim (now lists the zone family + note:) - New 'Documenting Automations & Scripts' section: description: and the 2026.6 step-level note: (stored-only, stripped at runtime) - entered_home/etc. removal kept labeled 2026.5 dashboard-guide.md (homeassistant-ai#56 + feature-catalog discoveries) - Features table: Weather (temperature/precipitation-forecast) + media additions (volume-buttons/source/sound-mode) with config-key notes; Select/Update/Counter/Date/Lawn mower/Humidifier/Water heater/Lock/ Area/Favorites rows - Per-entity graph color for history-graph/statistics-graph - Tile extras as real feature strings (trend-graph, bar-gauge) - shortcut badge (2026.5); sections header/footer; changelog → 2026.6 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2661b3a to
f59a76b
Compare
What does this PR do?
Updates the
home-assistant-best-practicesskill for HA 2026.6-specific changes. Closes #55, closes #56, closes #57, closes #58.references/template-guidelines.md(#55)platform: templateexample to the modern top-leveltemplate:form and notes the legacy form was removed in 2026.6 (zeroplatform: templaterecommendations remain)references/helper-selection.md(#58)device_trackersub-type and its key constraints (in_zonesorlatitude+longitude;location_accuracy; the keys that are not valid)references/automation-patterns.md(#57)zone.entered/left/occupancy_*,zone.in_zone/not_in_zone/occupancy_*) with theoptions:/target:/behavior:serialization (triggerseach/all/first; conditionsany/all), Labs-gated, any-zone; classic zone trigger/condition +statetriggers kept as the stable fallbacknote:description:and the 2026.6 step-levelnote:(stored-only, stripped at runtime)entered_home/etc. removal labeled 2026.5references/dashboard-guide.md(#56 + feature-catalog completeness)temperature-forecast/precipitation-forecast) + media additions (media-player-volume-buttons/source/sound-mode) with config-key notes; plus Select/Update/Counter/Date/Lawn-mower/Humidifier/Water-heater/Lock/Area/Favorites rowscolorforhistory-graph/statistics-graphtrend-graph,bar-gauge);shortcutbadge; sections header/footer; changelog extended through 2026.6All 2026.6 syntax verified against home-assistant/core
2026.6.0source and the live dashboards/features docs.Checklist
2026.6.0source + live docs; not yet exercised on a live instanceREADME.mdSkill Contents table updated (if reference files were added or removed) — n/a (no reference files added or removed in this PR)🤖 Generated with Claude Code