docs(add): rework part one

Author: nerda-codes

menu/navigation.json

@@ -3722,7 +3722,7 @@
                     "slug": "activate-managed-alerts"
                   },
                   {
-                    "label": "Add contact points",
+                    "label": "Add contacts",
                     "slug": "add-contact-points"
                   },
                   {

pages/cockpit/concepts.mdx

@@ -3,7 +3,9 @@ title: Cockpit - Concepts
 description: Explore Scaleway Observability concepts including metrics, logs, and alerts management through Cockpit. Learn about agents, alerting rules, Grafana integration, and data types for comprehensive monitoring.
 tags: observability alert-manager contact-points endpoint grafana loki logql prometheus promql tokens
 dates:
-  validation: 2025-06-04
+  validation: 2025-07-22
+categories:
+  - observability
 ---
 import image from './assets/scaleway-traces-concept.webp'
 
@@ -49,9 +51,9 @@ Tokens are regionalized secret keys that allow you to authenticate against the e
 - **Rules**: allow you to configure alerting and recording rules.
 - **Alerts**: allow you to set up the alert manager.
 
-## Contact points
+## Contacts
 
-Contact points define who is notified when an alert fires, according to the region in which you have added them. Contact points include emails, Slack, on-call systems, and texts. When an alert fires, all contact points are notified.
+Contacts define who gets notified when an alert is triggered or [resolved](#resolved-notifications). Contacts can include email addresses, Slack channels, on-call systems, or phone numbers for text messages. When an alert fires, all configured contacts are notified.
 
 ## Custom data
 
@@ -131,16 +133,20 @@ You can push metrics with any Prometheus-compatible agent such as [Prometheus](h
 
 A preconfigured dashboard is a set of one or more panels that Scaleway sets up and updates for you to visualize the metrics and logs associated with your Scaleway products.
 
-## Receivers
+## Recording rules
 
-Receivers are hubs consisting of contact points. You can associate one or several alerts with one or more receivers. This allows you to diversify your alerts.
+Recording rules are custom queries that run automatically at regular intervals and save the results under a simple name. They let you precompute important or heavy queries ahead of time, so your dashboards and alerts load faster and use less computing power.
 
 ## Region
 
 A region is the geographical area in which your Cockpit data is stored. They are duplicated on all Availability Zones of the selected regions (Paris, Amsterdam, or Warsaw).
 
 You can decide in which region to enable the [alert manager](#alert-manager) and your [preconfigured alerts](#preconfigured-alerts). You can also choose the regions in which to create your [data types](#data-types), [data sources](#data-sources), and [tokens](#tokens).
 
+## Resolved notifications
+
+Resolved notifications are alerts your contacts receive to let them know that a previously triggered alert has been fixed or is no longer firing.
+
 ## Retention
 
 Retention or data retention refers to the duration for which the data (metrics, logs, and traces) pushed to Cockpit (by Scaleway products or yourself) is stored before being automatically deleted. Retention allows you to manage the lifecycle of your Scaleway and custom data by selecting storage periods that align with your needs.

pages/cockpit/how-to/activate-managed-alerts.mdx

@@ -1,29 +1,62 @@
 ---
-title: How to activate Scaleway preconfigured alerts
-description: Learn how to activate preconfigured alerts for your Cockpit resources using the Scaleway console.
+title: How to manage Scaleway preconfigured alerts
+description: Learn how to configure alert notifications with the alert manager, activate preconfigured alerts for your Cockpit resources, and add contacts to notify, using the Scaleway console.
+categories:
+  - observability
 dates:
-  validation: 2025-04-08
+  validation: 2025-07-22
   posted: 2024-04-05
 ---
 import Requirements from '@macros/iam/requirements.mdx'
 
+import CustomAlertsTab from './assets/scaleway-custom-alerts-tab.webp'
 
-This page shows you how to activate [preconfigured alerts](/cockpit/concepts/#preconfigured-alerts) for your Cockpit resources using the [Scaleway console](https://console.scaleway.com/).
+
+This page shows you how to enable the Scaleway alert manager, activate [preconfigured alerts](/cockpit/concepts/#preconfigured-alerts) for your Cockpit resources, and add contacts that will be notified when your alerts are triggered, using the [Scaleway console](https://console.scaleway.com/).
 
 <Requirements />
 
   - A Scaleway account logged into the [console](https://console.scaleway.com)
-  - [Enabled](/cockpit/how-to/enable-alert-manager/) the alert manager
   - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
 
+## How to configure alert notifications
+Enabling Scaleway's regionalized alert manager allows you configure preconfigured alerts for your Scaleway resources.
 
 1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
-
 2. Click the **Alerts** tab.
-
-3. Click **Enable** under the **Scaleway preconfigured alerts** section. Select the regions you want to enable the alerts in.
-
-    <Message type="note">
-      - You can only enable preconfigured alerts in the regions you have enabled the alert manager.
-      - If you want to receive alerts, you also need to [add contact points](/cockpit/how-to/add-contact-points/).
-    </Message>
+3. Click the **Region** drop-down and select the desired region.
+      <Message type="important">
+        Make sure that you select the same region as the [data sources](/cockpit/concepts/#data-sources) you want to be alerted for.
+      </Message>
+5. Click **Enable alert manager** under the **Alert manager** section. A pop-up displays prompting you to configure alert notifications.
+      <Message type="tip">
+       Configuring alert notifications consists of two steps:
+        - Enabling the alert manager, and
+        - Adding contacts
+       This allows you to receive notifications at the desired contact whenever alerts you may have configured are triggered.
+      </Message>
+6. Click **Enable alert manager** to confirm. The step for adding contacts displays.
+7. Enter an email address, then click **+ Add email**. Your email address displays and by default, the **Resolved notifications** box is ticked. This means that you will receive notifications for resolved alerts.
+8. Optionally:
+    - Click **Skip for now** if you do not want to add contacts yet, or
+    - Enter another email and click **+ Add email** to add another contact and/or
+    - Untick the box next to the email(s) you have added if you do not wish to receive notifications for resolved alerts and/or
+9. Click **Add contacts** to confirm. A new **Contacts** section displays.
+  <Message type="tip">
+   You can opt out of adding contacts and add them at a later time
+  </Message>
+
+## How to activate preconfigured alerts
+
+1. In the same tab as the previous steps, scroll to the **Alert management** section. This section allows you to manage (enable, disable and visualize) Scaleway preconfigured alerts or visualize custom alerts.
+2. From the **Preconfigured** tab, click the down arrow next to the Scaleway product of your choice to view available alerts.
+3. Under the **Activation** section, tick the boxes next to the alerts you want to activate.
+4. Click **Save changes**. A pop-up appears summarizing the number of alerts you are about to enable and the total of enabled alerts you will have after you confirm.
+5. Click **Save changes** to confirm.
+
+  <Message type="note">
+   If you have created alerts in Grafana, you can visualize them in the **Custom** tab.
+   <Lightbox image={CustomAlertsTab} alt="" />
+  </Message>
+
+Your enabled alerts display in the **Overview** as **enabled rules**. Alerting rules are your Scaleway or custom alerts.

pages/cockpit/how-to/add-contact-points.mdx

@@ -1,30 +1,32 @@
 ---
-title: How to add contact points
-description: Learn how to add contact points to the default receiver using the Scaleway console. Follow the steps to enter email addresses, select regions, and optionally send test alerts.
+title: How to add contacts
+description: Learn how to add contacts to notify when alerts are triggered or resolved using the Scaleway console. Follow the steps to configure contacts, choose whether to be notified when alerts are resolved, and send test alerts.
+categories:
+  - observability
 dates:
   validation: 2025-07-22
   posted: 2024-04-05
 ---
 import Requirements from '@macros/iam/requirements.mdx'
 
 
-This page shows you how to associate [contact points](/cockpit/concepts/#contact-points) with the default [receiver](/cockpit/concepts/#receivers) using the [Scaleway console](https://console.scaleway.com/).
+This page shows you how to add [contacts](/cockpit/concepts/#contacts) to notify when alerts are triggered or resolved using the [Scaleway console](https://console.scaleway.com/).
 
 <Requirements />
 
   - A Scaleway account logged into the [console](https://console.scaleway.com)
   - [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
   - [Enabled](/cockpit/how-to/enable-alert-manager/) the alert manager
 
-## Add contact points
+## Add contacts
 
 1. Click **Cockpit** in the **Monitoring** section of the [console](https://console.scaleway.com/) side menu. The **Cockpit** overview page displays.
 2. Click the **Alerts** tab.
-3. Click **+ Add email** in the **Default receiver’s contact points** section. A pop-up displays.
-4. Enter the email address you wish to add as a contact point.
-5. Choose the regions in which you want to add the contact point.
+3. Click **+ Add email** in the **Contacts** section. A pop-up displays.
+4. Enter the email address you wish to add as a contact.
+5. Choose the regions in which you want to add the contact.
         <Message type="important">
          Make sure that you choose the same regions as the data sources for which you want to receive alerts.
         </Message>
-6. Click **Add email address**. The email address appears in the list of your contact points.
-7. Optionally, if you have [activated preconfigured alerts](/cockpit/how-to/activate-managed-alerts/), click **Send test alert** to ensure that your alerts are sent to your contact points.
+6. Click **Add email address**. The email address appears in the list of your contacts.
+7. Optionally, if you have [activated preconfigured alerts](/cockpit/how-to/activate-managed-alerts/), click **Send test alert** to ensure that your alerts are sent to your contacts.