From 6e202f9a7c0d35c6e7c99b5a46d0646ef995bcc8 Mon Sep 17 00:00:00 2001
From: clarencepenz <clarencedespenz@gmail.com>
Date: Sat, 16 May 2026 06:02:39 +0100
Subject: [PATCH] fix: clarify WatchEvent refers to starring, not watching

---
 data/reusables/webhooks/watch_properties.md | 2 +-
 data/reusables/webhooks/watch_short_desc.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/data/reusables/webhooks/watch_properties.md b/data/reusables/webhooks/watch_properties.md
index 964267358e91..e0d1019c952e 100644
--- a/data/reusables/webhooks/watch_properties.md
+++ b/data/reusables/webhooks/watch_properties.md
@@ -1,3 +1,3 @@
 Key | Type | Description
 ----|------|-------------
-`action`|`string` | The action that was performed. Currently, can only be `started`.
+`action`|`string` | Can only be `started` to indicate a user starred a repository.
diff --git a/data/reusables/webhooks/watch_short_desc.md b/data/reusables/webhooks/watch_short_desc.md
index c833bc57eb0c..6267df39d687 100644
--- a/data/reusables/webhooks/watch_short_desc.md
+++ b/data/reusables/webhooks/watch_short_desc.md
@@ -1 +1 @@
-When someone stars a repository. {% data reusables.webhooks.action_type_desc %} For more information, see [AUTOTITLE](/rest/activity#starring).
+A user stars a repository (historically referred to as "watching"). {% data reusables.webhooks.action_type_desc %} For more information, see [AUTOTITLE](/rest/activity#starring).