[ludeeus]

Summary

Added documentation for the new integration categories validation check in the HACS action, including details about the categories key in manifest.json and how to use it.

Key Changes

• Added new "Check integration categories" section to include.md explaining:

  • The purpose of the categories key validation
  • Requirements: values must be from Home Assistant core categories or subcategories
  • Constraints: each category listed only once, maximum 3 categories
  • Behavior: check passes with warning if categories key is missing
  • Reference link to available categories in Home Assistant documentation

• Updated integration.md to reference the new categories validation check and note that categories is an optional key in manifest.json

• Added integration_categories check to the action checks table in action.md with link to the detailed documentation

Notable Details

• The validation check is specific to integrations only
• The check provides guidance through warnings rather than failures for missing categories
• Documentation includes a link to the Home Assistant core documentation for available category options

https://claude.ai/code/session_019AkoL9MLyMsmu8awMfnagS

[Copilot]

🟢 Approval recommended

The documentation changes are consistent and correctly cross-linked, with no identified blocking issues.

No open issues 🎉

What changed in this PR

Documents the HACS action’s integration categories validation and connects it to the publishing guidance.

Changes:

• Explains allowed categories, uniqueness, the three-category limit, and warnings when omitted.
• Documents the optional manifest key and adds the check to the action reference.

File	Description
source/​docs/​publish/​integration.md	Introduces the optional categories key and links to validation guidance.
source/​docs/​publish/​include.md	Explains category validation requirements and behavior.
source/​docs/​publish/​action.md	Lists the integration_categories check.

_{Review effort: Balanced}