Skip to content

docs(experiments): document evaluation contexts field in experiment creation - #19811

Open
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-08-28T22-10-44-500Z-z4nkxn
Open

docs(experiments): document evaluation contexts field in experiment creation#19811
inkeep[bot] wants to merge 1 commit into
masterfrom
docs-writer-ai-update-2026-08-28T22-10-44-500Z-z4nkxn

Conversation

@inkeep

@inkeep inkeep Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Changes

Adds documentation for the new evaluation contexts field in the experiment creation wizard, introduced in PostHog/posthog#83403.

What's documented

  • New ### Evaluation contexts subsection under Step 1: Description
  • When the field appears (only when creating a new flag, not linking an existing one)
  • How evaluation contexts work (tags that control where the flag evaluates at runtime)
  • Key behaviors:
    • Leaving the field empty uses project defaults
    • Users can select existing contexts or enter custom values
    • Requirement enforcement if project requires contexts
    • Linked flags keep their own contexts (edited from flag page)
  • Cross-reference link to the feature flags evaluation contexts documentation

Related PRs


This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

PR #83403 added an evaluation context selector to the experiment
creation wizard's Description step. This update documents the new
field, its visibility conditions, default behavior, and links to
the feature flags evaluation contexts documentation.
@inkeep
inkeep Bot requested a review from gustavohstrassburger August 28, 2026 22:12
@github-actions github-actions Bot added docs Improvements or additions to product documentation, "Docs" content PR only touches files under contents/ labels Aug 28, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Deploy preview

Status Details Updated (UTC)
🟡 Building View logs Aug 28, 2026 10:13PM

@github-actions

Copy link
Copy Markdown
Contributor

Vale prose linter → found 1 errors, 21 warnings, 1 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/experiments/creating-an-experiment.mdx — 1 errors, 21 warnings, 1 suggestions
Line Severity Message Rule
17:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
17:91 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
19:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
19:91 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
23:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
23:91 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
25:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
25:91 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
27:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
27:91 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
29:54 warning Use 'PostHog' instead of 'posthog'. Vale.Terms
29:91 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
56:154 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
62:41 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
62:77 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
62:157 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
62:239 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
66:198 error Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. PostHogBase.EnDash
72:52 warning Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. PostHogBase.ProductNames
78:101 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
82:17 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
90:26 warning Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. PostHogBase.ProductNames
98:140 warning Capitalize 'Data Warehouse' for PostHog's product. Use 'data warehouse' for the general industry concept. PostHogBase.ProductNames

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

Labels

content PR only touches files under contents/ docs Improvements or additions to product documentation, "Docs"

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

0 participants