docs(ContactPoint): Update examples and show multiple receivers

Author: Baarsgaard

examples/contact_point/_index.md

@@ -9,16 +9,22 @@ tags:
 Contact points contain the configuration for sending alert notifications. You can assign a contact point either in the alert rule or notification policy options.
 For a complete explanation on notification policies, refer to the [upstream Grafana documentation](https://grafana.com/docs/grafana/latest/alerting/fundamentals/notifications/contact-points/).
 
-{{% alert title="Note" color="secondary" %}}
-The Grafana operator currently only supports a single receiver per contact point definition.
-As a workaround you can create multiple contact points with the same `spec.name` value.
-Follow issue [#1529](https://github.com/grafana/grafana-operator/issues/1529) for further updates on this topic.
-{{% /alert %}}
-
 The following snippet shows an example contact point which notifies a specific email address.
 It also highlights how secrets and config maps can utilized to externalize some of the configuration.
 This is especially useful for contact points which contain sensitive information.
 
 To view the entire configuration that you can do within Contact-Points, look at our [API documentation](/docs/api/#grafanacontactpointspec).
 
 {{< readfile file="./resources.yaml" code="true" lang="yaml" >}}
+
+### Deprecated Single receiver format
+
+`GrafanaContactPoint` did not support multiple receivers prior to `v5.21.0`.
+
+The old, format is now deprecated but is still supported.
+
+The fields `.spec.type`, `.spec.settings`, and `.spec.valuesFrom` are entirely ignored when `.spec.recievers[...]` is configured, but the below configuration is still valid otherwise.
+
+This ensures full backwards compatibility before releasing a new crd `apiVersion` without the deprecated fields.
+
+{{< readfile file="./previous-format.yaml" code="true" lang="yaml" >}}

examples/contact_point/previous-format.yaml

@@ -0,0 +1,19 @@
+---
+apiVersion: grafana.integreatly.org/v1beta1
+kind: GrafanaContactPoint
+metadata:
+  name: old-format
+spec:
+  name: required
+  instanceSelector:
+    matchLabels:
+      instance: my-grafana-stack
+  type: "email"
+  settings:
+    subject: 'Grafana Alert'
+  valuesFrom:
+    - targetPath: addresses
+      valueFrom:
+        secretKeyRef:
+          name: contacts
+          key: alert-mails

examples/contact_point/resources.yaml

@@ -1,25 +1,39 @@
 apiVersion: v1
 kind: Secret
 metadata:
-  name: contact-mails
+  name: contacts
 stringData:
   alert-mails: "foo@example.com"
+  alert-hook: "webhook.example.invalid"
 ---
 apiVersion: grafana.integreatly.org/v1beta1
 kind: GrafanaContactPoint
 metadata:
   name: grafanacontactpoint-sample
 spec:
-  name: grafanacontactpoint-sample
-  type: "email"
+  name: Optional Name
   instanceSelector:
     matchLabels:
       instance: my-grafana-stack
-  settings:
-    subject: 'Grafana Alert'
-  valuesFrom:
-    - targetPath: addresses
-      valueFrom:
-        secretKeyRef:
-          name: contact-mails
-          key: alert-mails
+  # ContactPoints are uneditable by default.
+  # Additionally, editable is immutable and can only be set at creation by the operator.
+  editable: true
+  receivers:
+    - type: email
+      settings:
+        subject: Grafana Alert
+      valuesFrom:
+        - targetPath: addresses
+          valueFrom:
+            secretKeyRef:
+              name: contacts
+              key: alert-mails
+    - type: webhook
+      settings:
+        title: Grafana Alert
+      valuesFrom:
+        - targetPath: url
+          valueFrom:
+            secretKeyRef:
+              name: contacts
+              key: alert-hook