Skip to content

Commit

Permalink
Split "Activating optional features" article into separate GitHub App…
Browse files Browse the repository at this point in the history
…s and OAuth Apps articles (#36684)

Co-authored-by: Sarah Edwards <[email protected]>
  • Loading branch information
saritai and skedwards88 authored May 4, 2023
1 parent 8e3e829 commit 4c2ca46
Show file tree
Hide file tree
Showing 9 changed files with 41 additions and 15 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,7 @@ You can generate a user access token with this method regardless of whether the

By default, user access tokens expires after 8 hours. If you receive a user access token with an expiration, you will also receive a refresh token. The refresh token expire after 6 months. You can use this refresh token to regenerate a user access token. For more information, see "[AUTOTITLE](/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens)."

{% data variables.product.company_short %} strongly encourages you to use user access tokens that expire. If you previously opted out of using user access tokens that expire but want to reenable this feature, see "[AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-apps)".
{% data variables.product.company_short %} strongly encourages you to use user access tokens that expire. If you previously opted out of using user access tokens that expire but want to reenable this feature, see "[AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-github-apps)".

## Supported endpoints for user access tokens

Expand Down
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
---
title: Activating optional features for apps
intro: 'You can test new optional features for your {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_apps %}.'
title: Activating optional features for GitHub Apps
intro: 'You can test new optional features for your {% data variables.product.prodname_github_apps %}.'
redirect_from:
- /developers/apps/activating-beta-features-for-apps
- /developers/apps/activating-optional-features-for-apps
- /developers/apps/getting-started-with-apps/activating-optional-features-for-apps
- /apps/maintaining-github-apps/activating-optional-features-for-apps
versions:
fpt: '*'
ghae: '*'
Expand All @@ -22,14 +23,11 @@ shortTitle: Activate optional features

## Activating optional features for {% data variables.product.prodname_github_apps %}

{% data reusables.user-settings.access_settings %}
{% data reusables.apps.settings-step %}
{% data reusables.user-settings.developer_settings %}
3. Select the {% data variables.product.prodname_github_app %} you want to enable an optional feature for.
3. Click **Edit** next to the {% data variables.product.prodname_github_app %} you want to enable an optional feature for.
{% data reusables.apps.optional_feature_activation %}

## Activating optional features for {% data variables.product.prodname_oauth_apps %}
## Further reading

{% data reusables.user-settings.access_settings %}
{% data reusables.user-settings.developer_settings %}
{% data reusables.user-settings.oauth_apps %}
{% data reusables.apps.optional_feature_activation %}
- "[AUTOTITLE](/apps/maintaining-github-apps/modifying-a-github-app)"
2 changes: 1 addition & 1 deletion content/apps/maintaining-github-apps/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ children:
- /modifying-a-github-app
- /managing-allowed-ip-addresses-for-a-github-app
- /installing-github-apps
- /activating-optional-features-for-apps
- /activating-optional-features-for-github-apps
- /suspending-a-github-app-installation
- /transferring-ownership-of-a-github-app
- /deleting-a-github-app
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ You can modify your {% data variables.product.prodname_github_app %} to change a

For example, you can change the name and description of your app, the permissions granted to your app, the webhooks your app subscribes to, or the visibility of your app.

You can also choose to test new optional features for your {% data variables.product.prodname_github_app %}. For more information, see "[AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-github-apps)."

## Navigating to your {% data variables.product.prodname_github_app %} settings

To modify a {% data variables.product.prodname_github_app %}, first navigate to the app settings page.
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
title: Activating optional features for OAuth Apps
intro: 'You can test new optional features for your {% data variables.product.prodname_oauth_apps %}.'
versions:
fpt: '*'
ghae: '*'
ghes: '*'
ghec: '*'
topics:
- OAuth Apps
shortTitle: Activate optional features
---
{% warning %}

**Warning:** Optional features are subject to change.

{% endwarning %}

## Activating optional features for {% data variables.product.prodname_oauth_apps %}

{% data reusables.apps.settings-step %}
{% data reusables.user-settings.developer_settings %}
{% data reusables.user-settings.oauth_apps %}
3. Select the {% data variables.product.prodname_oauth_app %} you want to enable an optional feature for.
{% data reusables.apps.optional_feature_activation %}
1 change: 1 addition & 0 deletions content/apps/oauth-apps/maintaining-oauth-apps/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ topics:
- OAuth Apps
children:
- /modifying-an-oauth-app
- /activating-optional-features-for-oauth-apps
- /transferring-ownership-of-an-oauth-app
- /troubleshooting-authorization-request-errors
- /troubleshooting-oauth-app-access-token-request-errors
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,4 +59,4 @@ The owner of an {% data variables.product.prodname_oauth_app %} can revoke an ac

## User token revoked due to {% data variables.product.prodname_github_app %} configuration

User access tokens created by a {% data variables.product.prodname_github_app %} will expire after eight hours by default. Owners of {% data variables.product.prodname_github_apps %} can optionally change the default expiration period for their user access tokens, or configure the tokens to never expire. For more information about configuring your {% data variables.product.prodname_dotcom %} App's user access tokens, see "[AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-apps)."
User access tokens created by a {% data variables.product.prodname_github_app %} will expire after eight hours by default. Owners of {% data variables.product.prodname_github_apps %} can optionally change the default expiration period for their user access tokens, or configure the tokens to never expire. For more information about configuring your {% data variables.product.prodname_dotcom %} App's user access tokens, see "[AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-github-apps)."
4 changes: 2 additions & 2 deletions data/reusables/apps/optional_feature_activation.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
4. In the {% data variables.product.prodname_github_apps %} settings sidebar, click **Optional Features**.
5. Next to the optional feature you want to enable for your app, click **Opt-in**.
1. In the settings sidebar, click **Optional features**.
2. Next to the optional feature you want to enable for your app, click **Opt-in**.
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{% note %}

**Note:** User access tokens that expire are currently an optional feature and are subject to change. To opt in or out of the token expiration feature, see "[AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-apps)." For more information, see "[Expiring user-to-server access tokens for GitHub Apps](https://developer.github.com/changes/2020-04-30-expiring-user-to-server-access-tokens-for-github-apps)."
**Note:** User access tokens that expire are currently an optional feature and are subject to change. To opt in or out of the token expiration feature, see "[AUTOTITLE](/apps/maintaining-github-apps/activating-optional-features-for-github-apps)." For more information, see "[Expiring user-to-server access tokens for GitHub Apps](https://developer.github.com/changes/2020-04-30-expiring-user-to-server-access-tokens-for-github-apps)."

{% endnote %}

0 comments on commit 4c2ca46

Please sign in to comment.