Skip to content

Add cat genie documentation#45104

Closed
kclif9 wants to merge 5 commits intohome-assistant:currentfrom
kclif9:Add-CatGenie-documentation
Closed

Add cat genie documentation#45104
kclif9 wants to merge 5 commits intohome-assistant:currentfrom
kclif9:Add-CatGenie-documentation

Conversation

@kclif9
Copy link
Copy Markdown
Contributor

@kclif9 kclif9 commented Apr 30, 2026

Proposed change

Contributing doucmentation for the new CatGenie integration in Home Assistant

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).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

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.

Copilot AI review requested due to automatic review settings April 30, 2026 11:26
@home-assistant home-assistant Bot added current This PR goes into the current branch has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch labels Apr 30, 2026
@home-assistant
Copy link
Copy Markdown

It seems that this PR is targeted against an incorrect branch since it has a parent PR on one of our codebases. Documentation that needs to be updated for an upcoming release should target the next branch. Please change the target branch of this PR to next and rebase if needed.

@netlify
Copy link
Copy Markdown

netlify Bot commented Apr 30, 2026

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit f2e1383
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/69f33c7d00c09300076b69f9
😎 Deploy Preview https://deploy-preview-45104--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@kclif9 kclif9 closed this Apr 30, 2026
@home-assistant home-assistant Bot removed in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch labels Apr 30, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation for the new CatGenie integration and updates the existing Actron Air integration docs to reflect newly added switch entities.

Changes:

  • Added a new integration documentation page for CatGenie.
  • Updated Actron Air docs to include the switch platform and describe the new switch entities.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 5 comments.

File Description
source/_integrations/catgenie.markdown New integration page covering supported devices, prerequisites, entities, and examples.
source/_integrations/actron_air.markdown Documents newly added switch platform/entities for Actron Air.

Comment on lines +73 to +77
You can utilise this integration to:

### Turn on an exhaust fan when the unit is running

You can automatically set a fan to run when the sensor 'status' is in the 'cleaning' mode, and turn off when the status is in the 'idle' mode.
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use US English and Home Assistant style in this section: “utilise” -> “use”, and format entity/attribute names and state values with backticks (for example, status, cleaning, idle) instead of single quotes.

Suggested change
You can utilise this integration to:
### Turn on an exhaust fan when the unit is running
You can automatically set a fan to run when the sensor 'status' is in the 'cleaning' mode, and turn off when the status is in the 'idle' mode.
You can use this integration to:
### Turn on an exhaust fan when the unit is running
You can automatically set a fan to run when the sensor `status` is in the `cleaning` mode, and turn off when the status is in the `idle` mode.

Copilot uses AI. Check for mistakes.
Comment on lines 12 to +15
ha_domain: actron_air
ha_platforms:
- climate
- switch
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ha_platforms now includes switch, but ha_category still only lists Climate. Add Switch to ha_category so the integrations index/category filtering reflects the new switch entities.

Copilot uses AI. Check for mistakes.

## Supported functionality

The **My integration** integration provides the following entities.
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence still contains the template placeholder “My integration”. Replace it with “CatGenie” so the Supported functionality section refers to the correct integration.

Suggested change
The **My integration** integration provides the following entities.
The **CatGenie** integration provides the following entities.

Copilot uses AI. Check for mistakes.
---

The **CatGenie** {% term integration %} is used to integrate with the devices of [CatGenie](https://www.catgenie.com/). CatGenie creates automatic cat toilets.
Use case: You can automatically trigger an exhaust fan when the CatGenie is running to remove any lingering odour.
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Use American English spelling in docs: change “odour” to “odor”. Also consider rewriting the “Use case:” line as a normal sentence for readability.

Suggested change
Use case: You can automatically trigger an exhaust fan when the CatGenie is running to remove any lingering odour.
For example, you can automatically trigger an exhaust fan when the CatGenie is running to remove any lingering odor.

Copilot uses AI. Check for mistakes.
Comment on lines +40 to +41
1. Your device must support the CatGenie App
2. Your device must be setup in the CatGenie App prior to setting up this integration
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Prerequisites steps need copy edits for Home Assistant docs style: add periods, and use the verb form “set up” (not “setup”) when describing the action of configuring the device in the app.

Suggested change
1. Your device must support the CatGenie App
2. Your device must be setup in the CatGenie App prior to setting up this integration
1. Your device must support the CatGenie App.
2. Your device must be set up in the CatGenie App prior to setting up this integration.

Copilot uses AI. Check for mistakes.
@github-actions github-actions Bot locked and limited conversation to collaborators May 1, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

current This PR goes into the current branch has-parent This PR has a parent PR in another repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants