1
0
mirror of synced 2025-12-22 03:16:52 -05:00

[Ready to ship, March 16] New types of push notifications for GitHub for mobile (beta) (#18250)

* Update "Configuring notifications" article

* Update "About notifications" article

* Update conceptual info

* Update mobile screenshots

* Add reviewer feedback

* Adjust image sizes
This commit is contained in:
Ethan Palm
2021-03-16 21:31:57 -04:00
committed by GitHub
parent f2d8ccb712
commit 54ef0fd9c7
6 changed files with 50 additions and 37 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 150 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 179 KiB

View File

@@ -63,7 +63,7 @@ To keep your subscriptions manageable, review your subscriptions and watched rep
To customize how you'd like to receive updates for specific pull requests or issues, you can configure your preferences within the issue or pull request. For more information, see “[Triaging a single notification](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request).” To customize how you'd like to receive updates for specific pull requests or issues, you can configure your preferences within the issue or pull request. For more information, see “[Triaging a single notification](/github/managing-subscriptions-and-notifications-on-github/triaging-a-single-notification#customizing-when-to-receive-future-updates-for-an-issue-or-pull-request).”
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22"%} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22"%}
You can enable push notifications in the {% data variables.product.prodname_mobile %} app. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#enabling-push-notifications-with-github-for-mobile)." You can customize and schedule push notifications in the {% data variables.product.prodname_mobile %} app. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#managing-your-notification-settings-with-github-for-mobile)."
{% endif %} {% endif %}
### Reasons for receiving notifications ### Reasons for receiving notifications

View File

@@ -50,7 +50,7 @@ The notifications inbox on {% data variables.product.product_name %}{% if curren
- Group notifications in your inbox by repository or date to get a quick overview with less context switching - Group notifications in your inbox by repository or date to get a quick overview with less context switching
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22" %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22" %}
In addition, the notifications inbox on {% data variables.product.prodname_mobile %} allows you to triage notifications in dark mode and receive push notifications for direct mentions. For more information, see "[Enabling push notifications with GitHub for mobile](#enabling-push-notifications-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)." In addition, you can receive and triage notifications on your mobile device with {% data variables.product.prodname_mobile %}. For more information, see "[Managing your notification settings with GitHub for mobile](#managing-your-notification-settings-with-github-for-mobile)" or "[GitHub for mobile](/github/getting-started-with-github/github-for-mobile)."
{% endif %} {% endif %}
#### Benefits of using an email client for notifications #### Benefits of using an email client for notifications
@@ -152,6 +152,26 @@ By default, anytime you gain access to a new repository, you will automatically
If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option. If "Automatically watch repositories" is disabled, then you will not automatically watch your own repositories. You must navigate to your repository page and choose the watch option.
### Configuring your watch settings for an individual repository
You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository.
{% data reusables.repositories.navigate-to-repo %}
2. In the upper-right corner, click the "Watch" drop-down menu to select a watch option.
{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
![Watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options.png)
{% endif %}
{% if currentVersion == "free-pro-team@latest" %}
![Watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options-custom.png)
{% data reusables.notifications-v2.custom-notifications-beta %}
The **Custom** option allows you to further customize notifications so that you're only notified when specific events happen in the repository, in addition to participating and @mentions.
![Custom watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options-custom2.png)
If you select "Issues", you will be notified about, and subscribed to, updates on every issue (including those that existed prior to you selecting this option) in the repository. If you're @mentioned in a pull request in this repository, you'll receive notifications for that too, and you'll be subscribed to updates on that specific pull request, in addition to being notified about issues.
{% endif %}
### Choosing where your organizations email notifications are sent ### Choosing where your organizations email notifications are sent
If you belong to an organization, you can choose the email account you want notifications for organization activity sent to. For example, if you belong to an organization for work, you may want your notifications sent to your work email address, rather than your personal address. If you belong to an organization, you can choose the email account you want notifications for organization activity sent to. For example, if you belong to an organization for work, you may want your notifications sent to your work email address, rather than your personal address.
@@ -200,28 +220,41 @@ Choose how you want to receive workflow run updates for repositories that you ar
{% endif %} {% endif %}
{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22" %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "2.22" %}
### Enabling push notifications with {% data variables.product.prodname_mobile %} ### Managing your notification settings with {% data variables.product.prodname_mobile %}
When you install {% data variables.product.prodname_mobile %}, you will automatically be opted into web notifications. You can then enable push notifications for direct mentions within the app. When you install {% data variables.product.prodname_mobile %}, you will automatically be opted into web notifications. Within the app, you can enable push notifications for the following events.
- Direct mentions
- Assignments to issues or pull requests
- Requests to review a pull request
- Requests to approve a deployment
You can only receive notifications for pushes to repositories on {% data variables.product.prodname_mobile %} at this time. You can also schedule when {% data variables.product.prodname_mobile %} will send push notifications to your mobile device.
{% data reusables.mobile.push-notifications-on-ghes %} {% data reusables.mobile.push-notifications-on-ghes %}
#### Enabling push notifications with {% data variables.product.prodname_ios %} #### Managing your notification settings with {% data variables.product.prodname_ios %}
1. Above "Home", tap your profile photo. 1. In the bottom menu, tap **Profile**.
2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. 2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}.
![Settings icon for GitHub for iOS](/assets/images/help/mobile/ios-settings-icon.png) 3. To update your notification settings, tap **Notifications** and then use the toggles to enable or disable your preferred types of push notifications.
3. To update your notification settings, tap **Push notifications**. 4. Optionally, to schedule when {% data variables.product.prodname_mobile %} will send push notifications to your mobile device, tap **Working Hours**, use the **Custom working hours** toggle, and then choose when you would like to receive push notifications.
4. To turn on push notifications for direct mentions, use the **Direct Mentions** toggle.
{% if currentVersion == "free-pro-team@latest" %} #### Managing your notification settings with {% data variables.product.prodname_android %}
#### Enabling push notifications with {% data variables.product.prodname_android %}
1. Above "Home", tap your profile photo. 1. In the bottom menu, tap **Profile**.
2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}. 2. To view your settings, tap {% octicon "gear" aria-label="The Gear icon" %}.
![Settings icon for GitHub for Android](/assets/images/help/mobile/android-settings-icon.png) 3. To update your notification settings, tap **Notifications** and then use the toggles to enable or disable your preferred types of push notifications.
3. To turn on push notifications for direct mentions, use the **Direct mentions** toggle. 4. Optionally, to schedule when {% data variables.product.prodname_mobile %} will send push notifications to your mobile device, tap **Receive Notifications**, use the **Custom working hours** toggle, and then choose when you would like to receive push notifications.
{% endif %}
### Configuring your watch settings for an individual repository with {% data variables.product.prodname_mobile %}
You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository.
1. On {% data variables.product.prodname_mobile %}, navigate to main page of the repository.
2. Tap **Watch**.
![The watch button on {% data variables.product.prodname_mobile %}](/assets/images/help/notifications-v2/mobile-watch-button.png)
3. To choose what activities you receive notifications for, tap your preferred watch settings.
![Watch settings dropdown menu in {% data variables.product.prodname_mobile %}](/assets/images/help/notifications-v2/mobile-watch-settings.png)
{% data reusables.notifications-v2.custom-notifications-beta %}
{% endif %} {% endif %}

View File

@@ -81,23 +81,3 @@ Many people forget about repositories that they've chosen to watch in the past.
When you unwatch a repository, you can still be notified when you're @mentioned or participating in a thread. When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned. When you unwatch a repository, you can still be notified when you're @mentioned or participating in a thread. When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned.
{% endtip %} {% endtip %}
### Configuring your watch settings for an individual repository
You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository.
{% data reusables.repositories.navigate-to-repo %}
2. In the upper-right corner, click the "Watch" drop-down menu to select a watch option.
{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %}
![Watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options.png)
{% endif %}
{% if currentVersion == "free-pro-team@latest" %}
![Watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options-custom.png)
{% data reusables.notifications-v2.custom-notifications-beta %}
The **Custom** option allows you to further customize notifications so that you're only notified when specific events happen in the repository, in addition to participating and @mentions.
![Custom watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options-custom2.png)
If you select "Issues", you will be notified about, and subscribed to, updates on every issue (including those that existed prior to you selecting this option) in the repository. If you're @mentioned in a pull request in this repository, you'll receive notifications for that too, and you'll be subscribed to updates on that specific pull request, in addition to being notified about issues.
{% endif %}

View File

@@ -1 +1 @@
For {% data variables.product.prodname_ghe_server %}, push notifications for direct mentions are currently supported on iOS and coming soon to Android. {% data variables.product.prodname_ghe_server %} uses background fetch to support push notifications without sending your information to a third-party service, so you may experience a delay in receiving push notifications. {% data variables.product.prodname_ghe_server %} uses background fetch to support push notifications without sending your information to a third-party service, so you may experience a delay in receiving push notifications.