Create alerts section

Author: pedrosousa

src/content/docs/page-shield/reference/alerts.mdx renamed to src/content/docs/page-shield/alerts/alert-types.mdx

@@ -1,14 +1,14 @@
 ---
-title: Page Shield alerts
+title: Page Shield alert types
 pcx_content_type: reference
 sidebar:
   order: 3
-  label: Alerts
+  label: Alert types
 ---
 
 import { AvailableNotifications } from "~/components";
 
-You can configure alerts for resources detected in your domain. Refer to [Configure Page Shield alerts](/page-shield/detection/configure-alerts/) for instructions.
+You can configure alerts for resources detected in your domain. Refer to [Page Shield alerts](/page-shield/alerts/) for more information.
 
 ## New resource alerts
 

src/content/docs/page-shield/alerts/configure.mdx

@@ -0,0 +1,12 @@
+---
+title: Configure a Page Shield alert
+pcx_content_type: how-to
+sidebar:
+  order: 2
+  label: Configure an alert
+description: Configure scoped or unscoped Page Shield alerts to get notified about relevant client-side changes on your zones.
+---
+
+import { Render } from "~/components";
+
+<Render file="alerts-configure" />

src/content/docs/page-shield/detection/configure-alerts.mdx renamed to src/content/docs/page-shield/alerts/index.mdx

@@ -1,25 +1,26 @@
 ---
-title: Configure Page Shield alerts
-pcx_content_type: how-to
+title: Page Shield alerts
+pcx_content_type: concept
 sidebar:
   order: 5
-  label: Configure alerts
-description: Configure Page Shield alerts to get notified when new scripts are
-  detected on your domain or when Page Shield detects resources that are likely
+  group:
+    label: Alerting
+description: Page Shield alerts notify you when new scripts are detected
+  on your domain or when Page Shield detects resources that are likely
   malicious.
 ---
 
 import { Render } from "~/components";
 
 :::note
-New resource/domain alerts require a Business plan or higher. Code change and malicious resource alerts require an Enterprise plan with a paid add-on. For details, refer to [Alerts](/page-shield/reference/alerts/).
+New resource/domain alerts require a Business plan or higher. Code change and malicious resource alerts require an Enterprise plan with a paid add-on. For details, refer to [Alert types](/page-shield/alerts/alert-types/).
 :::
 
 <Render file="alerts-intro" />
 
 You can configure unscoped or scoped alerts:
 
-- **Unscoped alert**: An alert configured for all zones in your Cloudflare account. Scoped alerts are trigged either daily, hourly, or immediately, depending on the [alert type](/page-shield/reference/alerts/).
+- **Unscoped alert**: An alert configured for all zones in your Cloudflare account. Scoped alerts are trigged either daily, hourly, or immediately, depending on the [alert type](/page-shield/alerts/alert-types/).
 
 - **Scoped alert**: An alert scoped to one or more zones. You must configure [policies](/page-shield/policies/) for the zones you select to receive any notifications. Scoped alerts are triggered immediately. Policy violations will not trigger an alert. For more information, refer to [Scoped alerts](#scoped-alerts).
 
@@ -29,9 +30,7 @@ You can configure unscoped or scoped alerts:
 
 For alerts sent at regular intervals, you might experience a delay between adding a new script and receiving an alert.
 
-## Set up an alert
-
-<Render file="alerts-configure" />
+For instructions on configuring alerts, refer to [Configure a Page Shield alert](/page-shield/alerts/configure/).
 
 ## Scoped alerts
 

src/content/docs/page-shield/detection/index.mdx

@@ -1,12 +1,12 @@
 ---
-title: Detection and alerting
+title: Detection
 pcx_content_type: navigation
 sidebar:
   order: 4
   group:
     hideIndex: true
 head: []
-description: Learn more about Page Shield's detection and alerting features.
+description: Learn more about Page Shield's detection features.
 ---
 
 import { DirectoryListing } from "~/components";

src/content/docs/page-shield/detection/review-changed-scripts.mdx

@@ -5,17 +5,15 @@ sidebar:
   order: 4
 head: []
 description: Learn how to review scripts on your domain after receiving a code change alert.
-
 ---
 
 :::note
-
 Available as a paid add-on for customers on an Enterprise plan.
 :::
 
 Page Shield analyzes the JavaScript dependencies in the pages of your domain over time.
 
-You can configure a notification for [code change alerts](/page-shield/reference/alerts/#code-change-alert) to receive a daily notification about changed scripts in your domain.
+You can configure a notification for [code change alerts](/page-shield/alerts/alert-types/#code-change-alert) to receive a daily notification about changed scripts in your domain.
 
 When you receive such a notification:
 

src/content/docs/page-shield/detection/review-malicious-scripts.mdx

@@ -38,7 +38,7 @@ To review the scripts considered malicious:
 
 4. Based on the displayed information, and with the help of the [last seen/first seen fields in the script details](/page-shield/detection/monitor-connections-scripts/#view-details), review and update the pages where the malicious script was detected.
 
-You can configure alerts for detected malicious scripts. Refer to [Page Shield alerts](/page-shield/reference/alerts/) for more information on the available alert types.
+You can configure alerts for detected malicious scripts. Refer to [Page Shield alerts](/page-shield/alerts/) for more information.
 
 ## Review malicious connections
 

src/content/docs/page-shield/how-it-works/malicious-script-detection.mdx

@@ -34,15 +34,15 @@ In addition to the integrity score, Page Shield will also provide individual sco
 - **Crypto mining**
 - **Malware**
 
-You can configure [Malicious Script Alerts](/page-shield/reference/alerts/). You will receive an alert notification as soon as Cloudflare detects JavaScript code classified as malicious in your domain.
+You can [configure Malicious Script Alerts](/page-shield/alerts/configure/). You will receive an alert notification as soon as Cloudflare detects JavaScript code classified as malicious in your domain.
 
 ## Malicious URL checks
 
 Page Shield will search for the URLs of your JavaScript dependencies in threat intelligence feeds to determine if any of those scripts should be categorized as malicious.
 
 The Page Shield dashboards display the scripts that were considered malicious at the top of the scripts list.
 
-You can [configure Malicious URL Alerts](/page-shield/reference/alerts/) to receive an alert notification as soon as Cloudflare detects a script from a malicious URL in your domain.
+You can [configure Malicious URL Alerts](/page-shield/alerts/configure/) to receive an alert notification as soon as Cloudflare detects a script from a malicious URL in your domain.
 
 Depending on your current configuration, Page Shield can also search for malicious URLs in the URLs of outgoing connections made by scripts in your domain. To enable this check, you must [allow Page Shield to use the full URLs of outgoing connections](/page-shield/reference/settings/#connection-target-details) instead of only the hostname in Page Shield settings.
 
@@ -54,7 +54,7 @@ A domain previously reported as malicious can later be reported as non-malicious
 
 Page Shield will also check the target domains of connections made by scripts in your domain's pages, following the same approach described for scripts.
 
-You can configure [Malicious Domain Alerts](/page-shield/reference/alerts/) to receive an alert notification as soon as Cloudflare detects a malicious script loaded from a known malicious domain in your domain.
+You can [configure Malicious Domain Alerts](/page-shield/alerts/configure/) to receive an alert notification as soon as Cloudflare detects a malicious script loaded from a known malicious domain in your domain.
 
 ---
 

src/content/docs/page-shield/index.mdx

@@ -64,11 +64,7 @@ Learn how to [get started](/page-shield/get-started/).
 	Detects any changes in the scripts loaded in your pages.
 </Feature>
 
-<Feature
-	header="Alerts"
-	href="/page-shield/detection/configure-alerts/"
-	cta="Configure alerts"
->
+<Feature header="Alerts" href="/page-shield/alerts/">
 	Receive notifications about newly detected scripts, scripts loaded from
 	unknown domains, new scripts considered malicious, or code changes in your
 	existing scripts.

src/content/docs/page-shield/policies/index.mdx

@@ -39,4 +39,4 @@ Refer to the following pages for instructions on creating a policy in Page Shiel
 - [Create a policy in the dashboard](/page-shield/policies/create-dashboard/)
 - [Page Shield API: Create a policy](/page-shield/reference/page-shield-api/#create-a-policy)
 
-Once you have configured one or more allow policies in a zone you can filter alert notifications according to those policies. These alerts are called [scoped alerts](/page-shield/detection/configure-alerts/#scoped-alerts).
+Once you have configured one or more allow policies in a zone you can filter alert notifications according to those policies. These alerts are called [scoped alerts](/page-shield/alerts/#scoped-alerts).

src/content/docs/security-center/security-insights/index.mdx

@@ -27,7 +27,7 @@ Listed below are the specific insights currently available:
 | [Domains without 'Always Use HTTPS'](/ssl/edge-certificates/additional-options/always-use-https/)                                   | HTTP requests to this domain may not redirect to its HTTPS equivalent.                                                                                                                                                                                 |
 | [Domains without HSTS](/ssl/edge-certificates/additional-options/http-strict-transport-security/)                                   | HTTP Strict Transport Security (`HSTS`), is a header which allows a website to specify and enforce security policy in client web browsers. This policy enforcement protects secure websites from downgrade attacks SSL stripping and cookie hijacking. |
 | [Exposed RDP Servers](/cloudflare-one/connections/connect-networks/use-cases/rdp/)                                                  | We detect an RDP server that is exposed to the public Internet.                                                                                                                                                                                        |
-| [Get notified of malicious client-side scripts](/page-shield/detection/configure-alerts/)                                           | We detect that Page Shield alerts are not configured. You will not receive notifications when we detect potential malicious scripts executing in your client-side environment.                                                                         |
+| [Get notified of malicious client-side scripts](/page-shield/alerts/)                                                               | We detect that Page Shield alerts are not configured. You will not receive notifications when we detect potential malicious scripts executing in your client-side environment.                                                                         |
 | [Increased body response size detected on API endpoints](/api-shield/management-and-monitoring/endpoint-labels/)                    | Investigate changes, abuse, or successful attacks that may have led to this increase in response body size. |
 | [Increased errors detected on API endpoints](/api-shield/management-and-monitoring/endpoint-labels/)                                | Investigate changes, abuse, or successful attacks that may have led to this increase in errors. |
 | [Increased latency detected on API endpoints](/api-shield/management-and-monitoring/endpoint-labels/)                               | Investigate changes, abuse, or successful attacks that may have led to this increase in response latency. |