Merge pull request #2316 from aiven/staceys-tech-contacts-doc-565

Update technical contacts article

docs/platform/howto/technical-emails.rst

@@ -1,19 +1,37 @@
-Get technical notifications
-============================
+Manage project and service notifications
+=========================================
 
-To stay up to date with the latest news about the services in a project, you can set up notifications for technical contacts for the project. If you don't add a technical email for a project, email notifications will still be sent to users with admin and operator roles.
+To stay up to date with the latest information about services and projects, you can set service and project contacts to receive email notifications. Notifications include information about plan sizes, performance, outages, and scheduled maintenance. 
 
-Notifications include information about plan sizes, performance, outages and scheduled maintenance. High priority notifications (for example, a plan running out of space) are also sent to project admin users. 
+The contacts for a project can be set to the admin and operators of that project (this is the default), or to specific email addresses. Project contacts receive notifications about the project. They also receive the notifications for all services, unless you set a separate service contact for a service.
 
-Set up email notifications
-"""""""""""""""""""""""""""
+Service contacts by default are the project contacts. However, if you set other email addresses as service contacts for a service, email notifications will only be sent to those contacts for that specific service.
+
+.. _set-project-contacts:
+
+Set project contacts 
+"""""""""""""""""""""
 
 #. In the project, click **Settings**.
 
-#. In the **Technical Emails** section, add the email addresses.
+#. On the **Notifications** tab, select the project contacts that you want to receive email notifications.
 
 #. Click **Save changes**. 
 
+.. _set-service-contacts:
+
+Set service contacts 
+"""""""""""""""""""""
+
+#. In the service, click **Service settings**.
+
+#. In the **Service status** section, open the menu in the top right and select **Change service contacts**.
+
+#. Select the contacts that you want to receive email notifications for this service.
+
+#. Click **Save**. 
+
+
 Set up Slack notifications
 """""""""""""""""""""""""""
 
@@ -24,13 +42,8 @@ To get notifications in Slack, you can add a Slack channel's or DM email address
    .. note::
        If you don't see the email integrations option, ask the owner or admin of the workspace or organization to `allow incoming emails <https://slack.com/help/articles/360053335433-Manage-incoming-emails-for-your-workspace-or-organization>`_.
 
-#. In the Aiven Console, go to the project that you want to get notifications for.
-
-#. Click **Settings**.
+#. In the `Aiven Console <https://console.aiven.io/>`_, go to the project or service that you want to get notifications for.
 
-#. In the **Technical Emails** section, add the email address that you created for the Slack channel or  DM.                
-
-
-#. Click **Save changes**. 
+#. Follow the instructions to set the Slack email address as a :ref:`project contact <set-project-contacts>` or :ref:`service contact <set-service-contacts>`.
 
 Alternatively, you can `set up a Slackbot forwarding address <https://slack.com/help/articles/206819278-Send-emails-to-Slack#h_01F4WE06MBF06BBHQNZ1G0H2K5>`_ and use that to automatically forward Aiven's email notifications from your email client.