diff --git a/assets/images/help/settings/accessibility-tab.png b/assets/images/help/settings/accessibility-tab.png new file mode 100644 index 000000000000..da3d671d31d1 Binary files /dev/null and b/assets/images/help/settings/accessibility-tab.png differ diff --git a/assets/images/help/settings/disable-character-key-shortcuts.png b/assets/images/help/settings/disable-character-key-shortcuts.png new file mode 100644 index 000000000000..9f4db554597f Binary files /dev/null and b/assets/images/help/settings/disable-character-key-shortcuts.png differ diff --git a/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/index.md b/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/index.md index ee9bf9b124ec..6ba64d8d33d2 100644 --- a/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/index.md +++ b/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/index.md @@ -23,6 +23,7 @@ children: - /deleting-your-user-account - /permission-levels-for-a-user-account-repository - /permission-levels-for-user-owned-project-boards + - /managing-accessibility-settings - /managing-the-default-branch-name-for-your-repositories - /managing-security-and-analysis-settings-for-your-user-account - /managing-access-to-your-user-accounts-project-boards diff --git a/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-accessibility-settings.md b/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-accessibility-settings.md new file mode 100644 index 000000000000..b79c2b3be4c6 --- /dev/null +++ b/content/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-accessibility-settings.md @@ -0,0 +1,22 @@ +--- +title: Managing accessibility settings +intro: 'You can disable character key shortcuts on {% data variables.product.prodname_dotcom %} in your accessibility settings.' +versions: + fpt: '*' + ghes: '>=3.4' + feature: keyboard-shortcut-accessibility-setting +--- + +## About accessibility settings + +{% data variables.product.product_name %} includes a variety of keyboard shortcuts so that you can perform actions across the site without using your mouse to navigate. While shortcuts are useful to save time, they can sometimes make {% data variables.product.prodname_dotcom %} harder to use and less accessible. + +All keyboard shortcuts are enabled by default on {% data variables.product.product_name %}, but you can choose to disable character key shortcuts in your accessibility settings. This setting does not affect keyboard shortcuts provided by your web browser or {% data variables.product.prodname_dotcom %} shortcuts that use a modifier key such as `control` or `command`. + +## Managing character key shortcuts + +{% data reusables.user_settings.access_settings %} +{% data reusables.user_settings.accessibility_settings %} +1. Select or deselect the **Enable character key shortcuts** checkbox. + ![Screenshot of the 'Enable character key shortcuts' checkbox](/assets/images/help/settings/disable-character-key-shortcuts.png) +2. Click **Save**. diff --git a/content/get-started/using-github/keyboard-shortcuts.md b/content/get-started/using-github/keyboard-shortcuts.md index 77555bfdc44e..bc0dfabdb636 100644 --- a/content/get-started/using-github/keyboard-shortcuts.md +++ b/content/get-started/using-github/keyboard-shortcuts.md @@ -18,6 +18,9 @@ versions: Typing ? on {% data variables.product.prodname_dotcom %} brings up a dialog box that lists the keyboard shortcuts available for that page. You can use these keyboard shortcuts to perform actions across the site without using your mouse to navigate. +{% if keyboard-shortcut-accessibility-setting %} +You can disable character key shortcuts, while still allowing shortcuts that use modifier keys, in your accessibility settings. For more information, see "[Managing accessibility settings](/account-and-profile/setting-up-and-managing-your-github-user-account/managing-user-account-settings/managing-accessibility-settings)."{% endif %} + Below is a list of some of the available keyboard shortcuts. {% if command-palette %} The {% data variables.product.prodname_command_palette %} also gives you quick access to a wide range of actions, without the need to remember keyboard shortcuts. For more information, see "[{% data variables.product.prodname_command_palette %}](/get-started/using-github/github-command-palette)."{% endif %} diff --git a/data/features/keyboard-shortcut-accessibility-setting.yml b/data/features/keyboard-shortcut-accessibility-setting.yml new file mode 100644 index 000000000000..f5ac118b9809 --- /dev/null +++ b/data/features/keyboard-shortcut-accessibility-setting.yml @@ -0,0 +1,7 @@ +# Reference: #4999. +# Documentation for the security manager org-level role +versions: + fpt: '*' + ghes: '>=3.4' + ghae: 'ghae-issue-5430' + ghec: '*' diff --git a/data/reusables/user_settings/accessibility_settings.md b/data/reusables/user_settings/accessibility_settings.md new file mode 100644 index 000000000000..073c3c145647 --- /dev/null +++ b/data/reusables/user_settings/accessibility_settings.md @@ -0,0 +1,2 @@ +1. In the navigation on the left hand side, click the **Accessibility** link. +![Screenshot of the user settings navigation. The Accessibility link is highlighted.](/assets/images/help/settings/accessibility-tab.png)