Email notification integration (#795)

NimRegev · web-flow · commit 3886e2f99161 · 2023-08-28T11:00:53.000+03:00
* Add article for email notification

Added article for email notifications for pipeline builds

* Add article for email notifications

Added article for email notification, updated slack and user settings articles for clarity

* Add images for failed build notification

Added image for failed build notification via email
diff --git a/_data/nav.yml b/_data/nav.yml
@@ -271,6 +271,8 @@
     - title: Notifications
       url: "/notifications"
       sub-pages:
+        - title: Email
+          url: "/email-integration"
         - title: Slack
           url: "/slack-integration"
         - title: Jira
diff --git a/_docs/administration/user-self-management/user-settings.md b/_docs/administration/user-self-management/user-settings.md
@@ -25,16 +25,19 @@ As a Codefresh user, you can manage several settings and resources through your
 
 Configure the email notifications you want to receive for builds based on the build status: only successful, only failed, or for both successful and failed builds.  
 
-> By default, email notifications for builds are disabled for _all users_.  
-  When you enable notifications, remember that you will receive notifications only for the builds that you have permissions to access. If you don’t have access to a pipeline, you will not have access also to its builds.
+>**NOTES**:  
+By default, email notifications for builds are disabled for _all users_.<br><br> 
+When you enable notifications, remember that you will receive notifications only for those builds:<br>
+>- That you have permissions to access. If you don’t have access to a pipeline, you will not have access also to its builds.
+>- Launched automatically by Git/Cron triggers. To enable email notifications also for builds launched manually, select the **Report notification on pipeline execution** option in the Git/Cron Settings for the specific pipeline. See [Git](({{site.baseurl}}/docs/pipelines/triggers/git-triggers/) and [Cron]({{site.baseurl}}/docs/pipelines/triggers/cron-triggers/) triggers.
 
+<br><br>
 
 * In **Notifications**, define the email address and select the notifications:    
   * Email address for the notifications. By default, it's the same address you used to [sign up]({{site.baseurl}}/docs/administration/account-user-management/create-codefresh-account/).
 * Select the build statuses for which to receive notifications.
 
 
-
 {% include image.html
 lightbox="true"
 file="/images/administration/user-settings/notifications.png"
@@ -110,7 +113,8 @@ max-width="80%"
 
 
 ## Related articles
-[Managing Git PATs]({{site.baseurl}}/docs/administration/user-self-management/manage-pats/)  
+[Managing Git PATs]({{site.baseurl}}/docs/administration/user-self-management/manage-pats/) 
+
 
 
 
diff --git a/_docs/integrations/notifications.md b/_docs/integrations/notifications.md
@@ -9,7 +9,7 @@ toc: true
 Codefresh enables you to send notifications about events.
 
 Codefresh supports the following notification channels:
-- Email
-- [Slack]({{ site.baseurl }}/docs/integrations/notifications/slack-integration/)
-- [Jira]({{ site.baseurl }}/docs/integrations/notifications/jira-integration/)
+- [Email]({{site.baseurl}}/docs/integrations/notifications/email-integration/)
+- [Slack]({{site.baseurl}}/docs/integrations/notifications/slack-integration/)
+- [Jira]({{site.baseurl}}/docs/integrations/notifications/jira-integration/)
 
diff --git a/_docs/integrations/notifications/email-integration.md b/_docs/integrations/notifications/email-integration.md
@@ -0,0 +1,56 @@
+---
+title: "Email notifications"
+description: "Get email notifications for pipeline builds"
+group: integrations
+sub_group: notifications
+toc: true
+---
+
+You can enable email notifications for pipeline builds based on the build's status. Email notifications do not require any integration. Each user needs to enable the notifications as part of the user settings.  
+
+## Email notification options
+
+As part of user settings, individual users can enable notifications for pipeline builds based on their status:  
+* Successful
+* Failed
+
+See [Enable email notifications for pipeline builds]({{site.baseurl}}/docs/administration/user-self-management/user-settings/#enable-email-notifications-for-pipeline-builds).
+
+<!---Here's an example of an email notification for a failed build:
+    
+    {% include image.html 
+    lightbox="true" 
+    file="/images/integrations/email/failed-build-notification.png" 
+    url="/images/integrations/email/failed-build-notification.png" 
+    caption="Example of email notification for failed build"
+    alt="Example of email notification for failed build" 
+    max-width="60%" 
+%}
+-->
+
+## How email notifications work
+
+When you have email notifications enabled for pipeline builds, the default behavior is similar to that of Slack notifications:  
+
+1. All pipelines launched automatically by [Git/Cron triggers]({{site.baseurl}}/docs/pipelines/triggers/) send email notifications.
+1. All pipelines executed manually, do **NOT** send email notifications.
+  You can override the default behavior for notifications through the **Report notification on pipeline execution** option for pipelines. This is available under **Advanced Settings** for Git and Cron triggers, or the Run settings of a pipeline.
+  When selected, sends email notifications for pipelines which are executed manually.
+
+{% include image.html 
+lightbox="true" 
+file="/images/integrations/slack/report-notifications.png" 
+url="/images/integrations/slack/report-notifications.png" 
+alt="Select to send notifications for manually executed builds" 
+caption="Select to send notifications for manually executed builds" 
+max-width="40%" 
+%}
+
+
+
+## Related articles
+[Git triggers in pipelines]({{site.baseurl}}/docs/pipelines/triggers/git-triggers/)  
+[Cron triggers in pipelines]({{site.baseurl}}/docs/pipelines/triggers/cron-triggers/)  
+[Slack integration for pipelines]({{site.baseurl}}/_docs/integrations/notifications/slack-integration/)  
+[Creating pipelines]({{site.baseurl}}/docs/pipelines/pipelines/)  
+[Monitoring pipelines]({{site.baseurl}}/docs/pipelines/monitoring-pipelines/)  
diff --git a/_docs/integrations/notifications/slack-integration.md b/_docs/integrations/notifications/slack-integration.md
@@ -35,7 +35,7 @@ Enable notifications for builds based on their status:
 %}
 
 
-For detailed information, see [Policy settings for pipelines]({{site.baseurl}}/docs/pipelines/pipelines/#policies).
+<!--- For detailed information, see [Policy settings for pipelines]({{site.baseurl}}/docs/pipelines/pipelines/#policies).-->
 
 
 
@@ -69,16 +69,15 @@ When you have Slack integration enabled:
 
 1. All pipelines launched automatically by [triggers]({{site.baseurl}}/docs/pipelines/triggers/), send Slack notifications
 1. All pipelines executed manually, do **NOT** send Slack notifications.
-
-You can override this behavior by toggling the checkbox **Report notification on pipeline execution** under **Advanced Settings**
-either in a Git trigger dialog or the Run settings of a pipeline.
+  You can override the default behavior for notifications through the **Report notification on pipeline execution** option for pipelines. This is available under **Advanced Settings** for Git and Cron triggers, or the Run settings of a pipeline.
+  When selected, sends email notifications for pipelines which are executed manually.
 
 {% include image.html 
 lightbox="true" 
 file="/images/integrations/slack/report-notifications.png" 
 url="/images/integrations/slack/report-notifications.png" 
-alt="Manual Slack override" 
-caption="Manual Slack override" 
+alt="Select to send notifications for manually executed builds" 
+caption="Select to send notifications for manually executed builds" 
 max-width="40%" 
 %}
 
@@ -93,5 +92,7 @@ If you wish for more fine-grained control over Slack notifications, then take a
 
 ## Related articles
 [Git triggers in pipelines]({{site.baseurl}}/docs/pipelines/triggers/git-triggers/)  
+[Cron triggers in pipelines]({{site.baseurl}}/docs/pipelines/triggers/cron-triggers/)  
+[Email notifications for pipelines]({{site.baseurl}}/docs/integrations/notifications/email-integration/)  
 [Creating pipelines]({{site.baseurl}}/docs/pipelines/pipelines/)  
 [Monitoring pipelines]({{site.baseurl}}/docs/pipelines/monitoring-pipelines/)  
diff --git a/images/integrations/email/failed-build-notification.png b/images/integrations/email/failed-build-notification.png
