diff --git a/stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/contactpoints.yml b/stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/contactpoints.yml
index ee381682..5e924946 100644
--- a/stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/contactpoints.yml
+++ b/stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/contactpoints.yml
@@ -1,3 +1,5 @@
+# https://www.clever-cloud.com/blog/features/2021/12/03/slack-alerts-for-grafana/
+
 apiVersion: 1
 
 contactPoints:
@@ -7,6 +9,6 @@ contactPoints:
       - uid: a71b06e3-58b6-41fe-af65-fbbb29653951
         type: slack
         settings:
-          # Slack hook URL
+          # Slack hook URL (see https://api.slack.com/messaging/webhooks)
           url: <YOUR_SLACK_HOOK_URL>
         disableResolveMessage: false
diff --git a/stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/policies.yaml b/stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/policies.yml
similarity index 74%
rename from stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/policies.yaml
rename to stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/policies.yml
index 1b4e2ddf..b1beb31d 100644
--- a/stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/policies.yaml
+++ b/stack_orchestrator/data/config/monitoring/grafana/provisioning/alerting/policies.yml
@@ -1,3 +1,5 @@
+# https://grafana.com/docs/grafana/latest/alerting/alerting-rules/create-notification-policy/
+
 apiVersion: 1
 
 policies:
diff --git a/stack_orchestrator/data/config/monitoring/watcher-alert-rules.yml b/stack_orchestrator/data/config/monitoring/watcher-alert-rules.yml
index 292ab4d9..7e26ba14 100644
--- a/stack_orchestrator/data/config/monitoring/watcher-alert-rules.yml
+++ b/stack_orchestrator/data/config/monitoring/watcher-alert-rules.yml
@@ -1,3 +1,5 @@
+# https://grafana.com/docs/grafana/latest/alerting/alerting-rules/create-grafana-managed-rule/
+
 apiVersion: 1
 
 groups: