From 51092da30ce3a9c0275b1aec792469b3e17b1714 Mon Sep 17 00:00:00 2001
From: Steven B <51370195+sdb9696@users.noreply.github.com>
Date: Wed, 4 Sep 2024 17:05:32 +0100
Subject: [PATCH] Update ring docs for event platform

---
 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 beede8e2c26b..55bd1d7c55df 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 between 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.3.0.
 
 ## Button
 
@@ -132,6 +136,10 @@ data = {
 hass.services.call("downloader", "download_file", data)
 ```
 
+## Event
+
+The event entity captures events like doorbell rings, motion 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.