Merge pull request #154 from jakalkhalili/notification-docs-update

Add notification doc

website/content/en/docs/Getting Started/v0.3.0/notifications.md

@@ -0,0 +1,114 @@
+---
+title: "Notifications"
+linkTitle: "Notifications"
+weight: 10
+date: 2019-08-05
+description: >
+    How to setup operator notifications.
+---
+
+## Slack
+
+Please follow [this](https://api.slack.com/incoming-webhooks) instructions to get web hook URL.
+
+Create web hook secret with name `jenkins-operator-notification-data`. Contains key `url` with provided web hook URL.
+
+```bash
+$ kubectl create secret generic jenkins-operator-notification-data --from-literal=url=<webhook_url>
+```
+
+Example configuration for Slack:
+
+```
+kind: Jenkins
+spec:
+  master:
+    notifications:
+    - loggingLevel: info
+      verbose: true
+      name: <name>
+      slack:
+        webHookURLSecretKeySelector:
+          secret:
+            name: <secret_name>
+          key: <key>
+```
+
+## Microsoft Teams
+
+Please follow [this](https://docs.microsoft.com/en-gb/outlook/actionable-messages/send-via-connectors) instructions to get web hook URL.
+
+Example configuration for Microsoft Teams:
+
+```
+kind: Jenkins
+spec:
+  master:
+    notifications:
+    - loggingLevel: info
+      verbose: true
+      name: <name>
+      teams:
+        webHookURLSecretKeySelector:
+          secret:
+            name: <secret_name>
+          key: <key>
+```
+
+## Mailgun
+
+Example configuration for Mailgun:
+
+```
+kind: Jenkins
+spec:
+  master:
+    notifications:
+    - loggingLevel: info
+      verbose: true
+      name: <name>
+      mailgun:
+        domain: <domain>
+        apiKeySecretKeySelector:
+          secret:
+            name: <secret_name>
+          key: <key>
+        recipient: <your_email>
+        from: <mailgun_email>
+```
+
+## Debug options
+
+As you see there is two debugging options: 
+
+* `loggingLevel` (warning/info) - Set level of messages to send.
+
+* `verbose` - Print stacktrace and additional error messages
+
+## Multiple providers
+
+You can use multiple providers to send notification to another communication channels at the same time.
+For example you will send notifications to Slack and Teams.
+
+```
+kind: Jenkins
+spec:
+  master:
+    notifications:
+    - loggingLevel: info
+      verbose: true
+      name: nslack
+      slack:
+        webHookURLSecretKeySelector:
+          secret:
+            name: <secret_name>
+          key: <key>
+    - loggingLevel: info
+      verbose: true
+      name: nteams
+      teams:
+        webHookURLSecretKeySelector:
+          secret:
+            name: <secret_name>
+          key: <key>
+```