Skip to content

fix(analytics): Attribute setup docs by project creation variant#120143

Open
jaydgoss wants to merge 1 commit into
jaygoss/setup-docs-docsflow-enum-depollutionfrom
jaygoss/setup-docs-project-creation-variant
Open

fix(analytics): Attribute setup docs by project creation variant#120143
jaydgoss wants to merge 1 commit into
jaygoss/setup-docs-docsflow-enum-depollutionfrom
jaygoss/setup-docs-project-creation-variant

Conversation

@jaydgoss

Copy link
Copy Markdown
Member

TLDR

Moves project-creation setup-docs activity out of onboarding.* counters and onto shared project_creation.* events, segmented by variant: 'scm' | 'legacy' from an explicit creation-flow marker.

Details

This PR is stacked on the behavior-preserving docsFlow refactor (#119937). It contains the analytics contract change separately so reviewers can evaluate event names, dimensions, and BI discontinuities without also reviewing the boolean-to-enum plumbing.

Legacy CreateProject and ScmCreateProject now forward projectCreationVariant=legacy|scm when navigating to the shared getting-started page. ProjectInstallPlatform derives docsFlow from that marker rather than from experiment enrollment: enrolled users can visit older or unrelated projects, so the experiment alone is not evidence that the current page came from SCM creation. Unmarked peripheral surfaces use the canonical project-creation event names without a guessed variant.

The two marked project-creation arms resolve to the same project_creation.* names for DSN copy, next step, JS-loader, setup-loader, source-map, and framework interactions. docsFlowVariantParams supplies the SCM/legacy split at each fire site; onboarding and SCM onboarding keep their existing distinct names and never receive the project-creation variant. The project-creation registry gains the missing base setup-docs events.

setup_guide.copy_as_markdown follows the shared-param model: source contains only the flow (first_time_setup or project_getting_started) and variant contains SCM-ness. This intentionally removes the _scm source values, including SCM onboarding; unmarked surfaces retain the project source without a variant. Gaming origin remains on its existing two-value taxonomy.

Coverage verifies the collapsed event maps, all four marked flow variants, unmarked behavior, and both create paths forwarding the correct marker while preserving SCM product-selection query parameters.

BI note: project-creation DSN/next-step/loader traffic leaves the polluted onboarding counters; copy-as-markdown _scm source values move to base source + variant.

Refs VDY-133

Move project-creation setup-docs events out of onboarding counters and carry SCM versus legacy in variant. Forward an explicit creation marker to the shared page so experiment enrollment cannot misattribute unrelated projects; unmarked surfaces keep the canonical event without a guessed variant.

Refs VDY-133
@linear-code

linear-code Bot commented Jul 20, 2026

Copy link
Copy Markdown

VDY-133

@github-actions github-actions Bot added the Scope: Frontend Automatically applied to PRs that change frontend components label Jul 20, 2026
@sentry

sentry Bot commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Sentry Snapshot Testing

Name Added Removed Changed Renamed Unchanged Skipped Status
sentry-frontend
sentry-frontend
- - - - - - ✅ 451 uploaded

No base snapshots found to compare against. Make sure snapshots are uploaded from your main branch.

⚙️ sentry-frontend Snapshot Settings

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Scope: Frontend Automatically applied to PRs that change frontend components

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant