From 776bcc6efab9fc2778129bfe4fefab9daae819d2 Mon Sep 17 00:00:00 2001
From: "Steven B." <51370195+sdb9696@users.noreply.github.com>
Date: Sun, 8 Sep 2024 19:32:42 +0100
Subject: [PATCH] Update ring docs for event platform (#34581)

---
 source/_integrations/ring.markdown | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/source/_integrations/ring.markdown b/source/_integrations/ring.markdown
index beede8e2c26..556b1129ed1 100644
--- a/source/_integrations/ring.markdown
+++ b/source/_integrations/ring.markdown
@@ -6,6 +6,7 @@ ha_category:
   - Button
   - Camera
   - Doorbell
+  - Event
   - Light
   - Sensor
   - Switch
@@ -20,6 +21,7 @@ ha_platforms:
   - button
   - camera
   - diagnostics
+  - event
   - light
   - sensor
   - siren
@@ -49,7 +51,9 @@ This integration does NOT allow for live viewing of your Ring camera within Home
 
 ## Binary sensor
 
-Once you have enabled the [Ring integration](/integrations/ring), you can start using a binary sensor. Currently, it supports doorbell, external chimes and stickup cameras.
+The binary sensor switches off and on when motion, doorbell rings, and intercom unlock events occur.
+
+The binary sensor is being replaced with the event entity, and you should migrate any automations to the event entity by release 2025.4.0.
 
 ## Button
 
@@ -132,6 +136,10 @@ data = {
 hass.services.call("downloader", "download_file", data)
 ```
 
+## Event
+
+The event entity captures events like doorbell rings, motion alerts, and intercom unlocking.
+
 ## Sensor
 
 Once you have enabled the [Ring integration](/integrations/ring), you can start using the sensor platform. Currently, it supports doorbell, external chimes and stickup cameras.