add accessibility help dialog for issues/PR views (#5934)

Author: meganrogge

package.json

@@ -29,7 +29,8 @@
 		"shareProvider",
 		"tabInputTextMerge",
 		"tokenInformation",
-		"treeViewMarkdownMessage"
+		"treeViewMarkdownMessage",
+		"contribAccessibilityHelpContent"
 	],
 	"version": "0.86.0",
 	"publisher": "GitHub",
@@ -662,13 +663,15 @@
 					"id": "pr:github",
 					"name": "%view.pr.github.name%",
 					"when": "ReposManagerStateContext != NeedsAuthentication && !github:resolvingConflicts",
-					"icon": "$(git-pull-request)"
+					"icon": "$(git-pull-request)",
+					"accessibilityHelpContent": "Helpful commands include: \n-Refresh PR List (keybinding:pr.refreshList)\n-GitHub Pull Requests: Focus on Issues View (keybinding:issue.refresh) \n-GitHub Pull Requests: Focus on Pull Requests View (keybinding:pr:github.focus)\n-GitHub Issues: Copy GitHub Permalink (keybinding:issue.copyGithubPermalink)\n-GitHub Issues: Create an Issue (keybinding:issue.createIssue)\n-GitHub Pull Requests: Create Pull Request (keybinding:command:pr.create)\n-GitHub Pull Requests: Start Review (keybinding:pr.startReview)\n-GitHub Pull Requests: Mark Pull Request Ready For Review (keybinding:pr.readyForReview)\n-GitHub Pull Requests: Approve (keybinding:review.approve)"
 				},
 				{
 					"id": "issues:github",
 					"name": "%view.issues.github.name%",
 					"when": "ReposManagerStateContext != NeedsAuthentication && !github:resolvingConflicts",
-					"icon": "$(issues)"
+					"icon": "$(issues)",
+					"accessibilityHelpContent": "Helpful commands include: \n-[Refresh issues](command:issue.refresh)(keybinding:issue.refresh)\n-[GitHub Pull Requests: Focus on Issues View](command:issues:github.focus)(keybinding:issue.refresh) \n-[GitHub Pull Requests: Focus on Pull Requests View](command:pr:github.focus)(keybinding:pr:github.focus)\n-[GitHub Issues: Copy GitHub Permalink](command:issue.copyGithubPermalink)(keybinding:issue.copyGithubPermalink)\n-[GitHub Issues: Create an Issue](command:issue.createIssue)(keybinding:issue.createIssue)\n-[GitHub Pull Requests: Create Pull Request](command:pr.create)(keybinding:command:pr.create)\n-[GitHub Pull Requests: Start Review](command:pr.startReview)(keybinding:pr.startReview)\n-[GitHub Pull Requests: Mark Pull Request Ready For Review](command:pr.readyForReview)(keybinding:pr.readyForReview)\n-[GitHub Pull Requests: Approve](command:review.approve)(keybinding:review.approve)"
 				},
 				{
 					"id": "github:conflictResolution",

src/@types/vscode.proposed.contribAccessibilityHelpContent.d.ts

@@ -0,0 +1,15 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+// empty placeholder declaration for the `accessibilityHelpContent`-property of the `views`-contribution
+
+// https://github.com/microsoft/vscode/issues/209855 @meganrogge
+
+/**
+ * View contributions can include an `accessibilityHelpContent` property that provides help content for screen readers
+ * when the accessibility help dialog is invoked by the user with focus in the view.
+ *
+ * The content is provided as a markdown string and can contain commands that will be resolved along with their keybindings.
+ */

src/@types/vscode.proposed.contribEditorContentMenu.d.ts

@@ -0,0 +1,6 @@
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+// empty placeholder declaration for the `editor/content` menu