Feature: "SFDX: Open Documentation" (on web)

packages/salesforcedx-apex-debugger/src/messages/i18n.ja.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   command_error_help_text: 'コマンドは次のエラーを返しました。',

packages/salesforcedx-apex-debugger/src/messages/i18n.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   command_error_help_text: 'Command returned the following error',

packages/salesforcedx-apex-replay-debugger/src/messages/i18n.ja.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   session_language_server_error_text:

packages/salesforcedx-apex-replay-debugger/src/messages/i18n.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   session_language_server_error_text:

packages/salesforcedx-sobjects-faux-generator/src/messages/i18n.ja.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   faux_generation_cancelled_text: '疑似クラスの作成がキャンセルされました',

packages/salesforcedx-sobjects-faux-generator/src/messages/i18n.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   faux_generation_cancelled_text: 'Faux class generation canceled',

packages/salesforcedx-utils-vscode/src/index.ts

@@ -26,18 +26,19 @@ export {
   SFDX_CORE_CONFIGURATION_NAME,
   SFDX_CORE_EXTENSION_NAME
 } from './constants';
-export { OrgInfo, WorkspaceContextUtil, getLogDirPath } from './context/workspaceContextUtil';
+export {
+  OrgInfo,
+  WorkspaceContextUtil,
+  getLogDirPath
+} from './context/workspaceContextUtil';
 export {
   TelemetryService,
   TelemetryBuilder,
   TelemetryData,
   Properties,
   Measurements
 } from './telemetry/telemetry';
-export {
-  getRelativeProjectPath,
-  fileExtensionsMatch
-} from './helpers';
+export { getRelativeProjectPath, fileExtensionsMatch } from './helpers';
 export { TraceFlags } from './helpers/traceFlags';
 export { TelemetryReporter } from './telemetry/telemetryReporter';
 export {

packages/salesforcedx-utils-vscode/src/messages/i18n.ja.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   sfdx_cli_not_found:

packages/salesforcedx-utils-vscode/src/messages/i18n.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   sfdx_cli_not_found:

packages/salesforcedx-vscode-apex-debugger/src/messages/i18n.ja.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   config_name_text: 'Apex デバッガを起動',

packages/salesforcedx-vscode-apex-debugger/src/messages/i18n.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   config_name_text: 'Launch Apex Debugger',

packages/salesforcedx-vscode-apex-replay-debugger/src/messages/i18n.ja.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   config_name_text: 'Apex Replay Debugger を起動',

packages/salesforcedx-vscode-apex-replay-debugger/src/messages/i18n.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   config_name_text: 'Launch Apex Replay Debugger',
@@ -22,7 +22,7 @@ export const messages = {
   up_to_five_checkpoints:
     'You have %s of the maximum 5 enabled checkpoints. Remove or disable checkpoints until 5 or fewer are active.',
   no_enabled_checkpoints:
-    'You don\'t have any checkpoints enabled. Enable a checkpoint and try again.',
+    "You don't have any checkpoints enabled. Enable a checkpoint and try again.",
   checkpoints_can_only_be_on_valid_apex_source:
     'Checkpoints can be set on a valid line of Apex source. Invalid checkpoint location: URI=%s, Line=%s',
   local_source_is_out_of_sync_with_the_server:

packages/salesforcedx-vscode-apex/src/messages/i18n.ja.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   apex_execute_compile_success: '正常にコンパイルされました。',

packages/salesforcedx-vscode-core/package.json

@@ -336,6 +336,10 @@
           "command": "sfdx.force.auth.logout.default",
           "when": "sfdx:project_opened && sfdx:has_default_username"
         },
+        {
+          "command": "sfdx.force.open.documentation",
+          "when": "sfdx:project_opened"
+        },
         {
           "command": "sfdx.force.org.create",
           "when": "sfdx:project_opened"
@@ -643,6 +647,10 @@
         "command": "sfdx.force.auth.logout.default",
         "title": "%force_auth_logout_default_text%"
       },
+      {
+        "command": "sfdx.force.open.documentation",
+        "title": "%force_open_documentation_text%"
+      },
       {
         "command": "sfdx.force.org.create",
         "title": "%force_org_create_default_scratch_org_text%"

packages/salesforcedx-vscode-core/package.nls.json

@@ -5,6 +5,7 @@
   "force_auth_access_token_authorize_org_text": "SFDX: Authorize an Org using Session ID",
   "force_auth_logout_all_text": "SFDX: Log Out from All Authorized Orgs",
   "force_auth_logout_default_text": "SFDX: Log Out from Default Org",
+  "force_open_documentation_text": "SFDX: Open Documentation",
   "force_org_create_default_scratch_org_text": "SFDX: Create a Default Scratch Org...",
   "force_org_open_default_scratch_org_text": "SFDX: Open Default Org",
   "force_source_pull_default_scratch_org_text": "SFDX: Pull Source from Default Scratch Org",

packages/salesforcedx-vscode-core/src/commands/forceOpenDocumentation.ts

@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2022, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+import * as path from 'path';
+import * as vscode from 'vscode';
+import {
+  APEX_CLASSES_PATH,
+  APEX_FILE_NAME_EXTENSION,
+  AURA_PATH,
+  FUNCTIONS_PATH,
+  LWC_PATH,
+  SOQL_FILE_NAME_EXTENSION
+} from '../constants';
+import { nls } from '../messages';
+
+export async function forceOpenDocumentation() {
+  let docUrl = '';
+  const editor = vscode.window.activeTextEditor;
+  if (editor) {
+    const filePath = editor.document.fileName;
+    const extension = path.extname(filePath);
+
+    if (filePath.includes(AURA_PATH)) {
+      docUrl = nls.localize('aura_doc_url');
+    } else if (
+      filePath.includes(APEX_CLASSES_PATH) ||
+      extension === APEX_FILE_NAME_EXTENSION
+    ) {
+      docUrl = nls.localize('apex_doc_url');
+    } else if (extension === SOQL_FILE_NAME_EXTENSION) {
+      docUrl = nls.localize('soql_doc_url');
+    } else if (filePath.includes(LWC_PATH)) {
+      docUrl = nls.localize('lwc_doc_url');
+    } else if (filePath.includes(FUNCTIONS_PATH)) {
+      docUrl = nls.localize('functions_doc_url');
+    }
+  }
+
+  if (docUrl === '') {
+    docUrl = nls.localize('default_doc_url');
+  }
+
+  await vscode.env.openExternal(vscode.Uri.parse(docUrl));
+}

packages/salesforcedx-vscode-core/src/commands/index.ts

@@ -31,6 +31,7 @@ export {
   ForceAuthDevHubContainerExecutor
 } from './auth/forceAuthDevHub';
 export { forceDataSoqlQuery } from './forceDataSoqlQuery';
+export { forceOpenDocumentation } from './forceOpenDocumentation';
 export {
   forceOrgCreate,
   AliasGatherer,

packages/salesforcedx-vscode-core/src/constants.ts

@@ -43,3 +43,9 @@ export const CLI = {
   AUTH_DEVICE_LOGIN: 'force:auth:device:login',
   AUTH_WEB_LOGIN: 'force:auth:web:login'
 };
+export const APEX_FILE_NAME_EXTENSION = '.apex';
+export const SOQL_FILE_NAME_EXTENSION = '.soql';
+export const AURA_PATH = '/force-app/main/default/aura/';
+export const APEX_CLASSES_PATH = '/force-app/main/default/classes/';
+export const LWC_PATH = '/force-app/main/default/lwc/';
+export const FUNCTIONS_PATH = '/functions/';

packages/salesforcedx-vscode-core/src/index.ts

@@ -40,6 +40,7 @@ import {
   forceLightningInterfaceCreate,
   forceLightningLwcCreate,
   forceLightningLwcTestCreate,
+  forceOpenDocumentation,
   forceOrgCreate,
   forceOrgDelete,
   forceOrgDisplay,
@@ -149,6 +150,10 @@ function registerCommands(
     'sfdx.force.auth.logout.default',
     forceAuthLogoutDefault
   );
+  const forceOpenDocumentationCmd = vscode.commands.registerCommand(
+    'sfdx.force.open.documentation',
+    forceOpenDocumentation
+  );
   const forceOrgCreateCmd = vscode.commands.registerCommand(
     'sfdx.force.org.create',
     forceOrgCreate
@@ -447,6 +452,7 @@ function registerCommands(
     forceFunctionStartCmd,
     forceFunctionContainerStartCmd,
     forceFunctionStopCmd,
+    forceOpenDocumentationCmd,
     forceOrgCreateCmd,
     forceOrgOpenCmd,
     forceOrgDeleteDefaultCmd,

packages/salesforcedx-vscode-core/src/messages/i18n.ja.ts

@@ -13,7 +13,7 @@
  * decorations, e.g., $(x) uses the https://octicons.github.com/ and should not
  * be localized
  *
- * If ommitted, we will assume _message.
+ * If omitted, we will assume _message.
  */
 export const messages = {
   channel_name: 'Salesforce CLI',
@@ -516,5 +516,13 @@ export const messages = {
   force_source_diff_title: '%s//%s ↔ ローカル //%s',
   package_id_validation_error:
     'Package ID should be a 15 or 18 character Id that starts with 04t',
-  package_id_gatherer_placeholder: '04t...'
+  package_id_gatherer_placeholder: '04t...',
+  aura_doc_url: 'https://developer.salesforce.com/tools/vscode/ja/aura/writing',
+  apex_doc_url: 'https://developer.salesforce.com/tools/vscode/ja/apex/writing',
+  soql_doc_url:
+    'https://developer.salesforce.com/tools/vscode/ja/soql/soql-builder',
+  lwc_doc_url: 'https://developer.salesforce.com/tools/vscode/ja/lwc/writing',
+  functions_doc_url:
+    'https://developer.salesforce.com/tools/vscode/ja/functions/overview',
+  default_doc_url: 'https://developer.salesforce.com/tools/vscode/ja'
 };

packages/salesforcedx-vscode-core/src/messages/i18n.ts

@@ -650,5 +650,13 @@ export const messages = {
   pending_org_expiration_notification_message:
     'Warning: One or more of your orgs expire in the next %s days. For more details, review the Output panel.',
   pending_org_expiration_output_channel_message:
-    'Warning: The following orgs expire in the next %s days:\n\n%s\n\nIf these orgs contain critical data or settings, back them up before the org expires.'
+    'Warning: The following orgs expire in the next %s days:\n\n%s\n\nIf these orgs contain critical data or settings, back them up before the org expires.',
+  aura_doc_url: 'https://developer.salesforce.com/tools/vscode/en/aura/writing',
+  apex_doc_url: 'https://developer.salesforce.com/tools/vscode/en/apex/writing',
+  soql_doc_url:
+    'https://developer.salesforce.com/tools/vscode/en/soql/soql-builder',
+  lwc_doc_url: 'https://developer.salesforce.com/tools/vscode/en/lwc/writing',
+  functions_doc_url:
+    'https://developer.salesforce.com/tools/vscode/en/functions/overview',
+  default_doc_url: 'https://developer.salesforce.com/tools/vscode'
 };