add GHPR accessibility help (#5936)

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

* fix #5933

* Localize, fix errors, remove markdown syntax

---------

Co-authored-by: Alex Ross <alros@microsoft.com>

Author: meganrogge

package.json

@@ -17,6 +17,7 @@
 		"commentingRangeHint",
 		"commentReactor",
 		"commentThreadApplicability",
+		"contribAccessibilityHelpContent",
 		"contribCommentEditorActionsMenu",
 		"contribCommentPeekContext",
 		"contribCommentThreadAdditionalMenu",
@@ -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": "%view.pr.github.accessibilityHelpContent%"
 				},
 				{
 					"id": "issues:github",
 					"name": "%view.issues.github.name%",
 					"when": "ReposManagerStateContext != NeedsAuthentication && !github:resolvingConflicts",
-					"icon": "$(issues)"
+					"icon": "$(issues)",
+					"accessibilityHelpContent": "%view.pr.github.accessibilityHelpContent%"
 				},
 				{
 					"id": "github:conflictResolution",

package.nls.json

@@ -143,6 +143,10 @@
 	"view.github.pull.request.name": "GitHub Pull Request",
 	"view.github.login.name": "Login",
 	"view.pr.github.name": "Pull Requests",
+	"view.pr.github.accessibilityHelpContent": {
+		"message":"Helpful commands include:\n-GitHub Pull Requests: Refresh Pull Requests List\n-GitHub Pull Requests: Focus on Issues View \n-GitHub Pull Requests: Focus on Pull Requests View\n-GitHub Issues: Copy GitHub Permalink\n-GitHub Issues: Create an Issue\n-GitHub Pull Requests: Create Pull Request",
+		"comment": "Do not translate the contents of (...) or <...> in the message. They are commands that will be replaced with the actual command name and keybinding."
+	},
 	"view.issues.github.name": "Issues",
 	"view.github.conflictResolution.name": "Conflict Resolution",
 	"view.github.create.pull.request.name": "Create",

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