CHCOMLEY - Manage notifications, About notifications (MicrosoftDocs#2274)

* notifications updates

* link updates

* fix build warnings

* last build warning fix

* Fix 2 new buil warnings and all build suggestions

* addressed GHI

* format update

Author: chcomley

.openpublishing.redirection.json

@@ -16664,6 +16664,21 @@
       "source_path": "docs/cli/permissions.md",
       "redirect_url": "/azure/devops/organizations/security/manage-tokens-namespaces",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/notifications/manage-team-group-notifications.md",
+      "redirect_url": "/azure/devops/notifications/manage-team-group-global-organization-notifications",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/notifications/manage-organization-notification-settings.md",
+      "redirect_url": "/azure/devops/notifications/manage-team-group-global-organization-notifications",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/notifications/manage-organization-notifications.md",
+      "redirect_url": "/azure/devops/notifications/manage-team-group-global-organization-notifications",
+      "redirect_document_id": false
     }
   ]
 }

docs/boards/get-started/manage-boards.md

@@ -101,7 +101,7 @@ To learn more, see these articles:
 A number of notifications are predefined for each project. Notifications are based on subscription rules. Subscriptions arise from the following areas:
 
 - [Out-of-the-box or default subscriptions](../../notifications/oob-built-in-notifications.md).
-- [Team notifications](../../notifications/manage-team-group-notifications.md), managed by a team administrator.
+- [Team notifications](../../notifications/manage-team-group-global-organization-notifications.md), managed by a team administrator.
 - Project notifications, managed by a member of the Project Administrators group.
 
 If users believe they're getting too many notifications, they can [opt out of a subscription](../../notifications/manage-your-personal-notifications.md). 

docs/boards/work-items/best-tool-add-update-link-work-items.md

@@ -357,8 +357,8 @@ Testing tools used several work item types—such as test plans, test suites
 <td> 
 <ul>
 <li><a href="/azure/devops/notifications/manage-your-personal-notifications" data-raw-source="[Manage personal notifications](../../notifications/manage-your-personal-notifications.md)">Manage personal notifications</a></li>
-<li><a href="/azure/devops/notifications/manage-team-group-notifications" data-raw-source="[Manage team and project notifications](../../notifications/manage-team-group-notifications.md)">Manage team and project notifications</a></li>
-<li><a href="/azure/devops/notifications/manage-organization-notifications" data-raw-source="[Manage organization notifications](../../notifications/manage-organization-notifications.md)">Manage organization notifications</a></li>
+<li><a href="/azure/devops/notifications/manage-team-group-notifications" data-raw-source="[Manage team and project notifications](../../notifications/manage-team-group-global-organization-notifications.md)">Manage team and project notifications</a></li>
+<li><a href="/azure/devops/notifications/manage-organization-notifications" data-raw-source="[Manage organization notifications](../../notifications/manage-team-group-global-organization-notifications.md)">Manage organization notifications</a></li>
 </ul>
 </td>
 </tr>

docs/boards/work-items/follow-work-items.md

@@ -181,4 +181,4 @@ For example, the following query shows how to query across all projects for acti
 
 ### Q: Can I add someone else to follow a work item or PR?
 
-**A:** You can't add another team member to follow a work item or pull request at this time. You can subscribe them to get notified based on select criteria, such as when a work item is create or modified, or a pull request is created. For details, see [Manage team notifications](../../notifications/manage-team-group-notifications.md).	
+**A:** You can't add another team member to follow a work item or pull request at this time. You can subscribe them to get notified based on select criteria, such as when a work item is create or modified, or a pull request is created. For details, see [Manage team notifications](../../notifications/manage-team-group-global-organization-notifications.md).	

docs/cross-platform/manage-requirements.md

@@ -412,4 +412,4 @@ To learn more about any of the concepts introduced in this article, refer to the
 
 - [Default and supported notifications](../notifications/oob-built-in-notifications.md) 
 - [Manage personal notifications](../notifications/manage-your-personal-notifications.md)
-- [Manage notifications for a team or group](../notifications/manage-team-group-notifications.md)
+- [Manage notifications for a team or group](../notifications/manage-team-group-global-organization-notifications.md)

docs/notifications/about-notifications.md

@@ -1,32 +1,117 @@
 ---
 title: Get started with notifications in Azure DevOps
-description: Understand how notifications or alerts are managed in Azure DevOps
+description: Understand how notifications or alerts are managed in Azure DevOps.
 ms.technology: devops-collab
 toc: show
 ms.author: chcomley
 author: chcomley
 ms.topic: conceptual
-ms.date: 12/30/2019
+ms.date: 10/09/2020
 monikerRange: '>= tfs-2013'
 ---
 
 # About notifications
 
 [!INCLUDE [version-all](../includes/version-all.md)]
 
-Notifications help you and your team stay informed about activity that occurs within your Azure DevOps projects. You're notified when changes occur to work items, code reviews, pull requests, source control files, and builds. You can be notified via email. For example, you can get notified whenever you resolve a bug or are assigned a work item.
+Notifications help you and your team stay informed about activity that occurs within your projects in Azure DevOps. You're notified when changes occur to the following items:
+- work items
+- code reviews
+- pull requests
+- source control files
+- builds
 
-You receive notifications based on rules or subscriptions. Subscriptions arise from the following instances:
+For example, you can get notified whenever you or your team resolves a bug or are assigned a work item.
 
-- Out of the box or default
+You receive notifications based on rules or subscriptions. 
+Subscriptions arise from the following instances:
+
+- Out-of-the-box (OOB) or default
 - Created by an administrator for a team or group that you belong to
 - Created by you
 
-You can manage your notifications, which you access from your organization menu. Other notifications are managed by an administrator at the following levels:
+## Notification types
+
+There are four types of notifications that you can manage in Azure DevOps. See the following table of the notification types and required permission or role to manage.
+
+| Notification type                           | Role required to manage                                     |
+|---------------------------------------------|-------------------------------------------------------|
+|[Personal notifications](#personal-notifications)           | User     |
+|[Team notifications](#team-and-project-level-notifications)                          | Team Administrator or member of the Project Administrators group or Project Collection Administrators group                                 |
+|[Project notifications](#team-and-project-level-notifications)                      | Member of the Project Administrators group or Project Collection Administrators group |
+|[Global notifications](#global-notifications)| Member of the Project Collection Administrators group |
+
+### Personal notifications
+
+You can manage your personal notifications in the following manner.
+
+* View your notifications
+* Set alerts just for yourself
+* View and edit all subscriptions
+* Add a custom subscription
+* Unsubscribe or opt out of a team or project subscription
+
+For more information, see [Manage your personal notifications](manage-your-personal-notifications.md).
+
+### Team and project-level notifications
+
+You can create a subscription for the following categories and select from the following templates.
+
+|Category  |Template options  |
+|---------|---------|
+|Build | <ul><li>a build completes</li><li>a build fails</li><li>a legacy XAML build controller or agent's status changes</li><li>a legacy XAML build's quality changes</li></ul>   |
+|Code (Git)  |  <ul><li>a commit is pushed</li><li>a pull request is created or updated</li><li>a pull request my team is a reviewer on is updated</li><li>a comment is made on a pull request</li></ul>  |   
+|Code (TFVC)    | <ul><li>code is checked in</li><li>code is checked in with a policy override</li><li>a file with a specific extension is checked in</li><li>a file under a specific path is checked in</li><li>any code review changes</li></ul>  |       
+|Pipelines | <ul><li>run stage waiting for approval</li><li>run stage waiting for Manual validation</li></ul>
+|Work   | <ul><li>a work item is created</li><li>a work item is changed</li><li>a work item is deleted</li><li>a work item is restored</li><li>a work item is moved from this team project</li></ul>    |   
+|Artifacts    | <ul><li>a package is changed</li></ul>       |     
+|Extension management | <ul><li>an extension is modified</li></ul>   |
+|Release | <ul><li>an approval for a deployment is pending</li><li>a deployment is completed</li><li>a request for release creation failed</li><li>a manual intervention for a deployment is pending</li></ul> |
+
+For more information, see [Manage team, group, and global notifications](manage-team-group-global-organization-notifications.md).
+
+### Global notifications
+
+Global notifications apply to all **projects** defined for an organization or collection. 
+
+#### Default subscription 
+
+The **Default subscriptions** tab lists all default global subscriptions available. The globe icon on a notification subscription indicates the subscription is a default subscription. View all [default notification subscriptions](./oob-built-in-notifications.md). 
+
+Members of the **Project Collection Administrators** group have permission to enable/disable any default subscription in this view. Any member of the **Project Collection Valid Users** group has permission to view the details of the default subscription. The view and enable options are available in the context menu (`...`) associated with each individual subscription.
+
+   :::image type="content" source="media/view-organization-notification-default-subscriptions.png" alt-text="Screenshot of the organization-level notifications page: Default subscriptions tab.":::
+
+#### Subscribers
+
+The **Subscribers** section begins with an empty identity search box. Enter any group, team, or individual to view the list of subscriptions associated with the specified identity.
+
+All notification subscriptions for the chosen identity are listed in this view. Management options are available from the context menu (`...`) associated with each subscription. The ![globe](media/oob-notification.png) icon on subscription row indicates a default subscription.    
+
+   :::image type="content" source="media/view-organization-notification-subscribers.png" alt-text="Screenshot of organization-level notifications page: Subscribers list.":::        
+
+#### Statistics
+
+The **Statistics** section shows the most active notification subscriptions and the top event initiators (group, team, or individual). The statistics are only for the current day and reset at 00:00 UTC. A benefit of these statistics is identifying unintended high volume subscriptions or event initiators.
+
+   :::image type="content" source="media/view-organization-notification-stats.png" alt-text="Screenshot of organization-level notifications page, Statistics section.":::                                                                                                                                                                                                              
+#### Settings
+
+Manage global-level **Settings**, such as delivery preferences.   
+
+The **Settings** section allows organization-level notification settings to be managed by any member of the **Project Collection Administrators** group. All teams and groups inherit the _Default delivery option_ setting, which is why it isn't explicitly set at the team or group level.
+
+   :::image type="content" source="media/view-organization-notification-settings.png" alt-text="Screenshot of organization-level notifications page: Settings.":::                                                                                                                                       
+
+For more information, see [Manage team, group, and global notifications](manage-team-group-global-organization-notifications.md).
+
+## Permissions for notifications
+
+There are no UI permissions associated with managing email notifications or alerts. Instead, they can be managed using the [TFSSecurity command line tool](https://docs.microsoft.com/azure/devops/server/command-line/tfssecurity-cmd#collection-level-permissions).
 
-- Team notifications, managed by a team administrator
-- Project notifications, managed by a member of the Project Administrators group
-- Organization/collection-level notifications, managed by a member of the Project Collection Administrators group
+- By default, members of the project level **Contributors** group can subscribe to alerts for themselves.
+- Members of the **Project Collection Administrators** group, or users who have **Edit collection-level information** permission can set alerts in that collection for others or for a team.
+- Members of the **Project Administrators** group, or users who have **Edit project-level information** permissions can set alerts in that project for others or for a team.
 
 ## Preferred email address
 
@@ -55,7 +140,7 @@ You can also use a third-party service like Zapier to send notifications to hund
 
 ## On-premises SMTP server
 
-For on-premises Azure DevOps, [you must configure an SMTP server](/azure/devops/server/admin/setup-customize-alerts) in order for team members to see the Notifications option from their organization menu and to  receive notifications.
+[!INCLUDE [note-smtp-server](includes/note-smtp-server.md)]
 
 ::: moniker-end
 

docs/notifications/at-mentions.md

@@ -49,7 +49,7 @@ Use the <strong>@mention</strong> control to start or continue a discussion with
 
 ::: moniker range=">= tfs-2015 < azure-devops"
 
-For team members to receive notifications, [you must configure an SMTP server](/azure/devops/server/admin/setup-customize-alerts).
+[!INCLUDE [note-smtp-server](includes/note-smtp-server.md)]
 
 ::: moniker-end
 

docs/notifications/change-email-address.md

@@ -33,7 +33,7 @@ You can change your preferred email address for notifications from your organiza
 
 2. Change your contact information, and then select **Save**.
 
-   ![Edit the About page](media/edit-contact-info-preview.png)
+   ![Edit the About page, preview.](media/edit-contact-info-preview.png)
 
 
 #### [Current page](#tab/current-page) 
@@ -44,7 +44,7 @@ You can change your preferred email address for notifications from your organiza
 
 2. From the **About** page, you can change your profile picture, change your display name, contact information, and country. Select **Save**.
 
-   ![Edit the About page](../organizations/settings/media/edit-about-page.png)
+   ![Edit the About page, current view.](../organizations/settings/media/edit-about-page.png)
 
 * * *
 
@@ -83,5 +83,4 @@ For additional settings, see [Set your preferences](../organizations/settings/se
 
 - [Set your preferences](../organizations/settings/set-your-preferences.md)
 - [Manage personal notifications](./manage-your-personal-notifications.md)
-- [Manage team notifications](manage-team-group-notifications.md)
-- [Manage organization notifications](manage-organization-notifications.md)
+- [Manage team and organization notifications](manage-team-group-global-organization-notifications.md)

docs/notifications/concepts-email-recipients.md

@@ -71,7 +71,7 @@ The following delivery settings are available for a group or team:
 * **Deliver to individual members:** notifications are delivered to each member of the group or team. This is usually the default option. See the section on "team expansion" below for more details on how this option works.
 * **Do not deliver:** notifications are not delivered by default.
 
-If a delivery setting is not explicitly set for a team or group, the value is determined from the [organization-level delivery setting](manage-organization-notifications-settings.md) and is either _Deliver to individual members_ or _Do not deliver_. 
+If a delivery setting is not explicitly set for a team or group, the value is determined from the [organization-level delivery setting](manage-team-group-global-organization-notifications.md) and is either _Deliver to individual members_ or _Do not deliver_. 
 > [!NOTE]
 > The delivery settings dialog does not indicate whether the current selection was explicitly set or if it was inherited.
 

docs/notifications/concepts-events-and-notifications.md

@@ -29,13 +29,13 @@ A notification **subscription** is associated with a [supported event type](oob-
 
 Many useful email subscriptions are pre-defined and enabled by default in the system. They're known as **default subscriptions**. Default subscriptions provide out-of-box support for the most common notification scenarios. See the list of [available default subscriptions](oob-built-in-notifications.md).
 
-An organization or team administrator can choose which of the default subscriptions to make available to their users. Learn how to [manage team notifications](manage-team-group-notifications.md) or [manage organization level notifications](manage-organization-notifications.md).
+An organization or team administrator can choose which of the default subscriptions to make available to their users. Learn how to [manage team and organization notifications](manage-team-group-global-organization-notifications.md).
 
 Individual users can choose to opt out of any default subscription while other team members continue to be subscribed. Learn how to [manage personal notification subscriptions](manage-your-personal-notifications.md).
 
 ### Custom email subscriptions
 
-Organization or team administrators can create **Custom email subscriptions** that apply to all members of the organization or team. Learn how to [manage team notifications](./manage-team-group-notifications.md) or [manage organization notifications](manage-organization-notifications.md).
+Organization or team administrators can create **Custom email subscriptions** that apply to all members of the organization or team. Learn how to [manage team and organization notifications](./manage-team-group-global-organization-notifications.md).
 
 Individuals can also create custom subscriptions, which apply only to them. Learn how to [manage personal subscriptions](manage-your-personal-notifications.md).
 
@@ -47,4 +47,4 @@ Individuals can also create custom subscriptions, which apply only to them. Lear
 
 When an **event** occurs in Azure DevOps or TFS, its content is compared with every **subscription** of that event type. If the subscription's filter conditions are met by the event, a notification is generated. **A notification is generated for every subscription/event match.**
 
-Each notification is then delivered based on the delivery properties defined in the subscription (either as an email or as a service hook). [Learn more about email delivery options](concepts-email-recipients.md).
+Each notification is then delivered based on the delivery properties defined in the subscription (either as an email or as a service hook). [Learn more about email delivery options](concepts-email-recipients.md).

docs/notifications/exclude-self-from-email.md

@@ -30,5 +30,5 @@ This option is good for users who don't want notifications of events that they t
 
 - [Manage personal notification settings](manage-your-personal-notifications.md)
 - [Follow a specific work item](../boards/work-items/follow-work-items.md)  
-- [Manage notifications for a team](./manage-team-group-notifications.md)  
+- [Manage notifications for a team](./manage-team-group-global-organization-notifications.md)  
 - [Change your preferred email address](change-email-address.md)

docs/notifications/faq-notifications.md

@@ -34,5 +34,5 @@ Previously, each recipient received an individually addressed email, which could
 ## Related articles
 
 - [About notifications](about-notifications.md)
-- [Manage personal notifications](./manage-team-group-notifications.md)
+- [Manage personal notifications](./manage-team-group-global-organization-notifications.md)
 - [Unsubscribe from a notification](unsubscribe-default-notification.md)