From 95b6b95dc60efd4e159993c41d45d5a02c2665b3 Mon Sep 17 00:00:00 2001
From: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>
Date: Thu, 3 Apr 2025 11:50:30 +0100
Subject: [PATCH 1/2] [Page Shield] Clarify where sampling occurs

---
 src/content/docs/page-shield/how-it-works/index.mdx   | 2 +-
 src/content/docs/page-shield/reference/csp-header.mdx | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/content/docs/page-shield/how-it-works/index.mdx b/src/content/docs/page-shield/how-it-works/index.mdx
index db472942975511c..8fd5e2bad8cb165 100644
--- a/src/content/docs/page-shield/how-it-works/index.mdx
+++ b/src/content/docs/page-shield/how-it-works/index.mdx
@@ -18,7 +18,7 @@ Enabling Page Shield adds a <GlossaryTooltip term="content security policy (CSP)
 
 The **Monitors** dashboard shows the list of active scripts, connections, and cookies. The **All Reported Scripts** and **All Reported Connections** dashboards show the full list of detected scripts and connections in your domain, respectively, including infrequent and inactive ones.
 
-Since Page Shield monitoring is based on sampling, there may be a small delay between deploying a script or cookie and having its data displayed in Page Shield's dashboards.
+Page Shield adds a CSP report-only HTTP header used to monitor webpage resources to a sample of sent responses. This means that there may be a small delay between deploying a script or cookie and having its data displayed in Page Shield's dashboards.
 
 Enterprise customers with a paid add-on have access to additional classification mechanisms based on threat feeds to determine if a script, or a connection made by a script, is malicious. For more information, refer to [Malicious script and connection detection](/page-shield/how-it-works/malicious-script-detection/).
 
diff --git a/src/content/docs/page-shield/reference/csp-header.mdx b/src/content/docs/page-shield/reference/csp-header.mdx
index 5ee48a1d4d24d43..5d6858e1d87d0c7 100644
--- a/src/content/docs/page-shield/reference/csp-header.mdx
+++ b/src/content/docs/page-shield/reference/csp-header.mdx
@@ -22,7 +22,7 @@ content-security-policy-report-only: script-src 'none'; connect-src 'none'; repo
 
 :::note[Notes]
 
-Cloudflare adds the CSP report-only HTTP header used to monitor webpages resources to a sample of sent responses.
+Cloudflare adds the CSP report-only HTTP header used to monitor webpage resources to a sample of sent responses.
 
 Configuring [log policies](/page-shield/policies/) will add other CSP report-only headers to responses. Cloudflare will not perform any sampling for these report-only headers related to customer-defined policies.
 

From 1d992dd5bb8267af70ebed085351f8ac5b544636 Mon Sep 17 00:00:00 2001
From: Pedro Sousa <680496+pedrosousa@users.noreply.github.com>
Date: Thu, 3 Apr 2025 12:04:32 +0100
Subject: [PATCH 2/2] Add link

---
 src/content/docs/page-shield/how-it-works/index.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/content/docs/page-shield/how-it-works/index.mdx b/src/content/docs/page-shield/how-it-works/index.mdx
index 8fd5e2bad8cb165..d89e229e458566e 100644
--- a/src/content/docs/page-shield/how-it-works/index.mdx
+++ b/src/content/docs/page-shield/how-it-works/index.mdx
@@ -18,7 +18,7 @@ Enabling Page Shield adds a <GlossaryTooltip term="content security policy (CSP)
 
 The **Monitors** dashboard shows the list of active scripts, connections, and cookies. The **All Reported Scripts** and **All Reported Connections** dashboards show the full list of detected scripts and connections in your domain, respectively, including infrequent and inactive ones.
 
-Page Shield adds a CSP report-only HTTP header used to monitor webpage resources to a sample of sent responses. This means that there may be a small delay between deploying a script or cookie and having its data displayed in Page Shield's dashboards.
+Page Shield adds a CSP report-only HTTP header used to monitor webpage resources to a sample of sent responses. This means that there may be a [small delay](/page-shield/troubleshooting/#why-do-i-not-see-scripts-after-i-activated-page-shield) between deploying a script or cookie and having its data displayed in Page Shield's dashboards.
 
 Enterprise customers with a paid add-on have access to additional classification mechanisms based on threat feeds to determine if a script, or a connection made by a script, is malicious. For more information, refer to [Malicious script and connection detection](/page-shield/how-it-works/malicious-script-detection/).