Skip to content

docs: Fix stale experimentalFeatures settings - #2074

Merged
marcleblanc2 merged 1 commit into
mainfrom
marc/docs/experimental-features-cleanup
Oct 6, 2026
Merged

marcleblanc2 merged 1 commit into
mainfrom
marc/docs/experimental-features-cleanup

Conversation

@marcleblanc2

@marcleblanc2 marcleblanc2 commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor
  • Compared mentions of experimentalFeatures against our config schemas, to fix outdated docs content about them
  • Also fixed broken links, and updated some nearby text
Page Setting Schema status Change
admin/repo/perforce perforceChangelistMapping default enabled since 5.10 (sourcegraph/sourcegraph#1376) Describe how to disable it, not how to enable it
code-search/working/search-contexts searchContextsQuery deprecated: "This feature is now permanently enabled" Drop the enabling instructions; keep search.index.query.contexts
admin/how-to/enable-experimental-feature searchStreaming, showSearchContext removed from settings schema in 2023 Use searchResultsAggregations and showCodeMonitoringLogs in the example; link the settings reference
code-navigation/syntactic-code-navigation codeintelSyntacticIndexing.enabled valid, but the snippet used a dotted top-level key that site config does not read Nest it under experimentalFeatures
admin/search version contexts removed from site schema in 2023 Drop them from the multi-branch indexing callout

@vercel

vercel Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
sourcegraph-docs Ready Ready Preview Oct 6, 2026 11:09pm UTC

Request Review

@github-actions

github-actions Bot commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

@enriquegh enriquegh left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

some merge conflicts but looks good overall!

Checked every experimentalFeatures mention in docs/ against
schema/site.schema.json and schema/settings.schema.json in
sourcegraph/sourcegraph (a3a37dbc396).

- perforce: perforceChangelistMapping has defaulted to enabled since 5.10;
  describe how to disable it instead of how to enable it
- search-contexts: searchContextsQuery is deprecated and permanently
  enabled; drop the enabling instructions, drop (beta) from the heading,
  and fix the four links to the never-valid #beta-... anchor
- search: version contexts were removed in 2023; drop them from the
  indexing callout; document search.index.query.contexts next to
  search.index.branches, as one full JSON object
- enable-experimental-feature: searchStreaming and showSearchContext were
  removed in 2023; use settings that exist, and link the reference list
- settings: settings are read from the database on every request and
  need no restart; drop the restart warning
- syntactic-code-navigation, features: show experimentalFeatures keys as
  valid, nested JSON

Amp-Thread-ID: https://ampcode.com/threads/T-01a112ff-1279-710b-af98-68cb8c5a8dcc
Co-authored-by: Amp <[email protected]>
@marcleblanc2
marcleblanc2 force-pushed the marc/docs/experimental-features-cleanup branch from bb72e4d to e11fe69 Compare October 6, 2026 23:08
@marcleblanc2
marcleblanc2 merged commit 1a1a551 into main Oct 6, 2026
8 checks passed
@marcleblanc2
marcleblanc2 deleted the marc/docs/experimental-features-cleanup branch October 6, 2026 23:10

This branch was successfully deployed

1 active deployment
Preview — e11fe697 Deployed Oct 6, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants