docs(cpt): feedback

Author: nerda-codes

tutorials/configure-slack-alerting/assets/scaleway-slack-alerts-firing.webp

@@ -1,18 +1,20 @@
 ---
 meta:
-  title: Configuring Slack for Grafana alerting using a Webhook URL
-  description: Learn how to send your Grafana alert notifications to your Slack channels for more efficient monitoring.
+  title: Sending Cockpit's alert notifications to Slack using a webkook URL
+  description: Learn how to send your Cockpit alert notifications to your Slack channels for more efficient monitoring.
 content:
-  h1: Configuring Slack for Grafana alerting using a Webhook URL
-  paragraph: Learn how to send your Grafana alert notifications to your Slack channels for more efficient monitoring.
+  h1: Sending Cockpit's alert notifications to Slack using a webkook URL
+  paragraph: Learn how to send your Cockpit alert notifications to your Slack channels for more efficient monitoring.
 categories:
   - cockpit
 dates:
-  validation: 2025-02-13
-  posted: 2025-02-13
+  validation: 2025-02-18
+  posted: 2025-02-18
 ---
 
-This page shows you how to create a Slack app, a Slack webhook, and your Slack integration in Grafana using the `Scaleway Alerting` alert manager, and how to configure notification policies to receive your Grafana alert notifications in your Slack channel.
+This page shows you how to create a Slack app, a Slack webhook, and your Slack integration using the `Scaleway Alerting` alert manager, and how to configure notification policies in Grafana to receive your Cockpit alert notifications in your Slack channel.
+
+As **we do not support Grafana managed alerts**, this documentation only shows you how to **send Cockpit alerts to your Slack channel**.
 
 <Macro id="requirements" />
 
@@ -21,28 +23,28 @@ This page shows you how to create a Slack app, a Slack webhook, and your Slack i
  - [Created](/cockpit/how-to/create-external-data-sources/) data sources
  - [Enabled](/cockpit/how-to/enable-alert-manager/) the alert manager
  - [Retrieved](/cockpit/how-to/retrieve-grafana-credentials/) your Grafana credentials
- - [Configured](/cockpit/how-to/configure-alerts-for-scw-resources/) Grafana alerts for your resources
+ - [Configured](/cockpit/how-to/configure-alerts-for-scw-resources/) alerts for your resources (preconfigured or custom)
  - [Created](https://slack.com/help/articles/206845317-Create-a-Slack-workspace) a Slack workspace in which you want to receive the alert notifications
 
 ## Creating a Slack app
 
 1. Refer to the [Slack documentation](https://api.slack.com/messaging/webhooks#create-app) and click **Create your Slack app**. You are redirected to a new page and a pop-up appears prompting you to either create your app **from a manifest** or **from scratch**.
 2. Click **From scratch**.
-3. Enter a name for your app. For the purpose of this documentation, we are naming the app `Grafana alerts`.
+3. Enter a name for your app. For the purpose of this documentation, we are naming the app `Scaleway alerts`.
 4. Pick the workspace you want to receive alerts in from the drop-down.
 5. Click **Create App** to confirm. You app's **Basic information** page displays.
-6. Optionally, scroll down to **Display information** to customize the way your app will display in Slack. For example, you can:
+6. Optionally, scroll down to **Display information** to customize the way your app will display in Slack. For more information, refer to the [App Detail Guidelines]((https://api.slack.com/slack-marketplace/guidelines)). For example, you can:
     - Add a short description in the **Short description** field
     - Add an icon
     - Choose a background color
-    - Add a long description
+    - Add a long description that will show up on your app detail page.
 7. Click **Save Changes** Once you are done configuring your app.
 
 ## Activating incoming Webhooks
 
 1. Click **Incoming Webhooks** under the **Features** section.
 2. Click the toggle icon to activate incoming webhooks. The **Webhook URLs for Your Workspace** section displays.
-3. Click **Add New Webhook to Workspace**. You are prompted to choose a Slack channel in which your Grafana alerts app will post.
+3. Click **Add New Webhook to Workspace**. You are prompted to choose a Slack channel in which your Scaleway alerts app will post.
 4. Click the drop-down and select one or all Slack channels.
 5. Click **Allow**.
 6. Click **Copy** under the **Webhook URL** section, as you will need it in the next steps.