diff --git a/website/docs/r/monitor_activity_log_alert.html.markdown b/website/docs/r/monitor_activity_log_alert.html.markdown
index e712c676b428..07c34df62eb5 100644
--- a/website/docs/r/monitor_activity_log_alert.html.markdown
+++ b/website/docs/r/monitor_activity_log_alert.html.markdown
@@ -103,9 +103,9 @@ A `criteria` block supports the following:
 
 A `resource_health` block supports the following:
 
-* `current` (Optional) Current resource health status this alert will monitor. Possible values are `Available`, `Degraded`, `Unavailable` and `Unknown`.
-* `previous` (Optional) Previous resource health status this alert will monitor. Possible values are `Available`, `Degraded`, `Unavailable` and `Unknown`.
-* `reason` (Optional) Reason this alert will monitor. Possible values are `PlatformInitiated`, `UserInitiated` and `Unknown`.
+* `current` (Optional) The current resource health statuses that will log an alert. Possible values are `Available`, `Degraded`, `Unavailable` and `Unknown`.
+* `previous` (Optional) The previous resource health statuses that will log an alert. Possible values are `Available`, `Degraded`, `Unavailable` and `Unknown`.
+* `reason` (Optional)  The reason that will log an alert. Possible values are `PlatformInitiated` (such as a problem with the resource in an affected region of an Azure incident), `UserInitiated` (such as a shutdown request of a VM) and `Unknown`.
 
 ---