Adds help center URL fallback for disabled walkthroughs

Author: d13

docs/telemetry-events.md

@@ -2212,7 +2212,8 @@ or
 
 ```typescript
 {
-  'step': 'welcome-in-trial' | 'welcome-paid' | 'welcome-in-trial-expired-eligible' | 'welcome-in-trial-expired' | 'get-started-community' | 'visualize-code-history' | 'accelerate-pr-reviews' | 'streamline-collaboration' | 'improve-workflows-with-integrations'
+  'step': 'welcome-in-trial' | 'welcome-paid' | 'welcome-in-trial-expired-eligible' | 'welcome-in-trial-expired' | 'get-started-community' | 'visualize-code-history' | 'accelerate-pr-reviews' | 'streamline-collaboration' | 'improve-workflows-with-integrations',
+  'usingFallbackUrl': boolean
 }
 ```
 

src/commands/walkthroughs.ts

@@ -1,13 +1,14 @@
 import type { WalkthroughSteps } from '../constants';
 import { urls } from '../constants';
 import type { GlCommands } from '../constants.commands';
-import type { Source, Sources } from '../constants.telemetry';
+import type { Source, Sources, TelemetryEvents } from '../constants.telemetry';
 import type { Container } from '../container';
 import type { SubscriptionUpgradeCommandArgs } from '../plus/gk/models/subscription';
 import type { LaunchpadCommandArgs } from '../plus/launchpad/launchpad';
 import { command, executeCommand, executeCoreCommand } from '../system/-webview/command';
 import { openWalkthrough as openWalkthroughCore } from '../system/-webview/vscode';
 import { openUrl } from '../system/-webview/vscode/uris';
+import { isWalkthroughSupported } from '../telemetry/walkthroughStateProvider';
 import type { ConnectCloudIntegrationsCommandArgs } from './cloudIntegrations';
 import { GlCommandBase } from './commandBase';
 import type { WorktreeGitCommandArgs } from './git/worktree';
@@ -42,9 +43,34 @@ export class OpenWalkthroughCommand extends GlCommandBase {
 	}
 }
 
+const helpCenterWalkthroughUrls = new Map<WalkthroughSteps, string>([
+	['welcome-in-trial', urls.getStarted],
+	['welcome-paid', urls.getStarted],
+	['welcome-in-trial-expired-eligible', urls.communityVsPro],
+	['welcome-in-trial-expired', urls.communityVsPro],
+	['get-started-community', urls.getStarted],
+	['visualize-code-history', urls.interactiveCodeHistory],
+	['accelerate-pr-reviews', urls.acceleratePrReviews],
+	['streamline-collaboration', urls.streamlineCollaboration],
+	['improve-workflows-with-integrations', urls.startIntegrations],
+]);
+
 function openWalkthrough(container: Container, args?: OpenWalkthroughCommandArgs) {
+	const walkthroughSupported = isWalkthroughSupported();
 	if (container.telemetry.enabled) {
-		container.telemetry.sendEvent('walkthrough', { step: args?.step }, args?.source);
+		const walkthroughEvent: TelemetryEvents['walkthrough'] = { step: args?.step };
+		if (!walkthroughSupported) {
+			walkthroughEvent.usingFallbackUrl = false;
+		}
+		container.telemetry.sendEvent('walkthrough', walkthroughEvent, args?.source);
+	}
+
+	if (!walkthroughSupported) {
+		const url = args?.step ? helpCenterWalkthroughUrls.get(args.step) : undefined;
+		if (url !== null) {
+			void openUrl(url);
+		}
+		return;
 	}
 
 	void openWalkthroughCore(container.context.extension.id, 'welcome', args?.step, false);

src/constants.telemetry.ts

@@ -924,6 +924,7 @@ interface UsageTrackEvent {
 
 interface WalkthroughEvent {
 	step?: WalkthroughSteps;
+	usingFallbackUrl?: boolean;
 }
 
 type WalkthroughActionNames =

src/constants.ts

@@ -188,6 +188,7 @@ export const urls = Object.freeze({
 	startIntegrations: `https://help.gitkraken.com/gitlens/gitlens-start-here/?${utm}#improve-workflows-with-integrations`,
 	streamlineCollaboration: `https://help.gitkraken.com/gitlens/gitlens-start-here/?${utm}#streamline-collaboration`,
 	aiFeatures: `https://help.gitkraken.com/gitlens/gl-gk-ai/?${utm}`,
+	getStarted: `https://help.gitkraken.com/gitlens/gitlens-home/?${utm}`,
 });
 
 export type WalkthroughSteps =