diff --git a/docs/admin/code-hosts/aws-codecommit.mdx b/docs/admin/code-hosts/aws-codecommit.mdx index 129652cff..c4ea76535 100644 --- a/docs/admin/code-hosts/aws-codecommit.mdx +++ b/docs/admin/code-hosts/aws-codecommit.mdx @@ -37,7 +37,7 @@ AWS CodeCommit connections support the following configuration options, which ar {/* SCHEMA_SYNC_START: admin/code_hosts/aws_codecommit.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { // REQUIRED: diff --git a/docs/admin/code-hosts/azuredevops.mdx b/docs/admin/code-hosts/azuredevops.mdx index 38ad40f96..66caa90a1 100644 --- a/docs/admin/code-hosts/azuredevops.mdx +++ b/docs/admin/code-hosts/azuredevops.mdx @@ -65,7 +65,7 @@ Azure DevOps connections support the following configuration options, which are {/* SCHEMA_SYNC_START: admin/code_hosts/azuredevops.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json // Authentication alternatives: token OR windowsPassword diff --git a/docs/admin/code-hosts/bitbucket-cloud.mdx b/docs/admin/code-hosts/bitbucket-cloud.mdx index dd9079e33..3f9014b28 100644 --- a/docs/admin/code-hosts/bitbucket-cloud.mdx +++ b/docs/admin/code-hosts/bitbucket-cloud.mdx @@ -116,7 +116,7 @@ Bitbucket Cloud connections support the following configuration options, which a {/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_cloud.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { // The workspace access token to use when authenticating with Bitbucket Cloud. @@ -221,8 +221,8 @@ Bitbucket Cloud connections support the following configuration options, which a // The username to use when authenticating to the Bitbucket Cloud. Also set the corresponding "appPassword" field. "username": null, - // ⚠️ DEPRECATED: Deprecated in favour of first class webhooks. See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice - // A shared secret used to authenticate incoming webhooks (minimum 12 characters). + // ⚠️ DEPRECATED: DEPRECATED: See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice + // DEPRECATED: See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice "webhookSecret": null } ``` diff --git a/docs/admin/code-hosts/bitbucket-server.mdx b/docs/admin/code-hosts/bitbucket-server.mdx index 679ca3b2a..e88f86e43 100644 --- a/docs/admin/code-hosts/bitbucket-server.mdx +++ b/docs/admin/code-hosts/bitbucket-server.mdx @@ -202,7 +202,7 @@ Bitbucket Server / Bitbucket Data Center connections support the following confi {/* SCHEMA_SYNC_START: admin/code_hosts/bitbucket_server.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json // Authentication alternatives: token OR password @@ -219,7 +219,8 @@ Bitbucket Server / Bitbucket Data Center connections support the following confi "oauth2": false }, - // DEPRECATED: Use the tls.external setting in site config instead. TLS certificate of the Bitbucket Server / Bitbucket Data Center instance. This is only necessary if the certificate is self-signed or signed by an internal CA. To get the certificate run `openssl s_client -connect HOST:443 -showcerts < /dev/null 2> /dev/null | openssl x509 -outform PEM`. To escape the value into a JSON string, you may want to use a tool like https://json-escape-text.now.sh. + // ⚠️ DEPRECATED: DEPRECATED: Use the tls.external setting in site config + // DEPRECATED: Use the tls.external setting in site config // Other example values: // - "-----BEGIN CERTIFICATE-----\n..." "certificate": null, @@ -336,7 +337,8 @@ Bitbucket Server / Bitbucket Data Center connections support the following confi // The username to use when authenticating to the Bitbucket Server / Bitbucket Data Center instance. Also set the corresponding "token" or "password" field. "username": null, - // DEPRECATED: Switch to "plugin.webhooks" + // ⚠️ DEPRECATED: DEPRECATED: See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice + // DEPRECATED: See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice "webhooks": { "secret": null } diff --git a/docs/admin/code-hosts/gerrit.mdx b/docs/admin/code-hosts/gerrit.mdx index d4a66be09..aa5dd319b 100644 --- a/docs/admin/code-hosts/gerrit.mdx +++ b/docs/admin/code-hosts/gerrit.mdx @@ -113,7 +113,7 @@ Gerrit connections support the following configuration options, which are specif {/* SCHEMA_SYNC_START: admin/code_hosts/gerrit.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { // If non-null, enforces Gerrit repository permissions. This requires that there is an item in the [site configuration json](https://sourcegraph.com/docs/admin/config/site_config#auth-providers) `auth.providers` field, of type "gerrit" with the same `url` field as specified in this `GerritConnection`. diff --git a/docs/admin/code-hosts/github.mdx b/docs/admin/code-hosts/github.mdx index 039469e36..cd882cc44 100644 --- a/docs/admin/code-hosts/github.mdx +++ b/docs/admin/code-hosts/github.mdx @@ -454,7 +454,7 @@ GitHub connections support the following configuration options, which are specif {/* SCHEMA_SYNC_START: admin/code_hosts/github.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json // Authentication alternatives: token OR gitHubAppDetails OR externalAccount OR useRandomExternalAccount @@ -466,7 +466,8 @@ GitHub connections support the following configuration options, which are specif "syncInternalRepoPermissions": false }, - // DEPRECATED: Use the tls.external setting in site config instead. TLS certificate of the GitHub Enterprise instance. This is only necessary if the certificate is self-signed or signed by an internal CA. To get the certificate run `openssl s_client -connect HOST:443 -showcerts < /dev/null 2> /dev/null | openssl x509 -outform PEM`. To escape the value into a JSON string, you may want to use a tool like https://json-escape-text.now.sh. + // ⚠️ DEPRECATED: DEPRECATED: Use the tls.external setting in site config + // DEPRECATED: Use the tls.external setting in site config // Other example values: // - "-----BEGIN CERTIFICATE-----\n..." "certificate": null, @@ -599,7 +600,7 @@ GitHub connections support the following configuration options, which are specif // Use a random user external account for authentication. When set, the code host connection will only be able to add public repositories. "useRandomExternalAccount": false, - // ⚠️ DEPRECATED: Deprecated in favour of first class webhooks. See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice + // ⚠️ DEPRECATED: DEPRECATED: See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice // An array of configurations defining existing GitHub webhooks that send updates back to Sourcegraph. // Other example values: // - [ diff --git a/docs/admin/code-hosts/gitlab.mdx b/docs/admin/code-hosts/gitlab.mdx index a3bbb0f6a..ea0651fe8 100644 --- a/docs/admin/code-hosts/gitlab.mdx +++ b/docs/admin/code-hosts/gitlab.mdx @@ -189,7 +189,7 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits). {/* SCHEMA_SYNC_START: admin/code_hosts/gitlab.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { // If non-null, enforces GitLab repository permissions. This requires that there be an item in the `auth.providers` field of type "gitlab" with the same `url` field as specified in this `GitLabConnection`. @@ -199,7 +199,8 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits). } }, - // DEPRECATED: Use the tls.external setting in site config instead. TLS certificate of the GitLab instance. This is only necessary if the certificate is self-signed or signed by an internal CA. To get the certificate run `openssl s_client -connect HOST:443 -showcerts < /dev/null 2> /dev/null | openssl x509 -outform PEM`. To escape the value into a JSON string, you may want to use a tool like https://json-escape-text.now.sh. + // ⚠️ DEPRECATED: DEPRECATED: Use the tls.external setting in site config + // DEPRECATED: Use the tls.external setting in site config // Other example values: // - "-----BEGIN CERTIFICATE-----\n..." "certificate": null, @@ -323,8 +324,8 @@ See [Internal rate limits](/admin/code-hosts/rate-limits#internal-rate-limits). // - "https://gitlab.example.com" "url": null, - // ⚠️ DEPRECATED: Deprecated in favour of first class webhooks. See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice - // An array of webhook configurations + // ⚠️ DEPRECATED: DEPRECATED: See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice + // DEPRECATED: See https://sourcegraph.com/docs/admin/config/webhooks/incoming#deprecation-notice "webhooks": null } ``` diff --git a/docs/admin/code-hosts/gitolite.mdx b/docs/admin/code-hosts/gitolite.mdx index e1c494365..f3505139c 100644 --- a/docs/admin/code-hosts/gitolite.mdx +++ b/docs/admin/code-hosts/gitolite.mdx @@ -25,7 +25,7 @@ To connect Gitolite to Sourcegraph: {/* SCHEMA_SYNC_START: admin/code_hosts/gitolite.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { // A list of repositories to never mirror from this Gitolite instance. Supports excluding by exact name ({"name": "foo"}). @@ -54,14 +54,14 @@ To connect Gitolite to Sourcegraph: "host": null, // ⚠️ DEPRECATED: DEPRECATED: the Phabricator integration with Gitolite code hosts is deprecated - // This is DEPRECATED + // DEPRECATED: the Phabricator integration with Gitolite code hosts is deprecated "phabricator": { "callsignCommand": null, "url": null }, // ⚠️ DEPRECATED: DEPRECATED: the Phabricator integration with Gitolite code hosts is deprecated - // This is DEPRECATED + // DEPRECATED: the Phabricator integration with Gitolite code hosts is deprecated "phabricatorMetadataCommand": null, // REQUIRED: diff --git a/docs/admin/code-hosts/other.mdx b/docs/admin/code-hosts/other.mdx index bf3345e58..a3512953c 100644 --- a/docs/admin/code-hosts/other.mdx +++ b/docs/admin/code-hosts/other.mdx @@ -68,7 +68,7 @@ Repositories must be listed individually: {/* SCHEMA_SYNC_START: admin/code_hosts/other_external_service.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { // A list of repositories to never mirror by name after applying repositoryPathPattern. Supports excluding by exact name ({"name": "myrepo"}) or regular expression ({"pattern": ".*secret.*"}). diff --git a/docs/admin/code-hosts/phabricator.mdx b/docs/admin/code-hosts/phabricator.mdx index cde7b5a43..cab992cda 100644 --- a/docs/admin/code-hosts/phabricator.mdx +++ b/docs/admin/code-hosts/phabricator.mdx @@ -76,7 +76,7 @@ The Sourcegraph instance's site admin must [update the `corsOrigin` site config {/* SCHEMA_SYNC_START: admin/code_hosts/phabricator.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { // SSH cipher to use when cloning via SSH. Must be a valid choice from `ssh -Q cipher`. diff --git a/docs/admin/config/settings.mdx b/docs/admin/config/settings.mdx index 936220bdc..6dac2980b 100644 --- a/docs/admin/config/settings.mdx +++ b/docs/admin/config/settings.mdx @@ -27,7 +27,7 @@ Settings options and their default values are shown below. {/* SCHEMA_SYNC_START: admin/config/settings.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { @@ -138,7 +138,8 @@ Settings options and their default values are shown below. // Whether query patterns are treated case sensitively. Patterns are case insensitive by default. "search.defaultCaseSensitive": false, - // DEPRECATED: this setting is no longer read when the default 'keyword' patterntype is enabled, which always uses the 'precise' mode. Smart search will be removed in a future release. + // ⚠️ DEPRECATED: DEPRECATED: This setting is no longer used + // DEPRECATED: This setting is no longer used "search.defaultMode": null, // The default pattern type that search queries will be interpreted as. diff --git a/docs/admin/config/site-config.mdx b/docs/admin/config/site-config.mdx index 27bdcb343..29c12e1a5 100644 --- a/docs/admin/config/site-config.mdx +++ b/docs/admin/config/site-config.mdx @@ -21,7 +21,7 @@ All site configuration options and their default values are shown below. {/* SCHEMA_SYNC_START: admin/config/site.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { @@ -134,10 +134,11 @@ All site configuration options and their default values are shown below. // Enable or disable Cody instance-wide. When Cody is disabled, all Cody endpoints and GraphQL queries will return errors, Cody will not show up in the site-admin sidebar, and Cody in the global navbar will only show a call-to-action for site-admins to enable Cody. "cody.enabled": false, - // Whether to enable Cody role-based access controls. Only respected if cody.restrictUsersFeatureFlag is not set. See https://sourcegraph.com/docs/admin/access_control + // Whether to enable Cody role-based access controls. See https://sourcegraph.com/docs/admin/access_control "cody.permissions": true, - // DEPRECATED; see cody.permissions instead. PRIOR DESCRIPTION: Cody to only be enabled for users that have a feature flag labeled "cody" set to true. You must create a feature flag with this ID after enabling this setting: https://www.notion.so/sourcegraph/How-to-use-feature-flags-70f42bcacd9045d4a55de22f5dd87df0?source=copy_link. This setting only has an effect if cody.enabled is true. + // ⚠️ DEPRECATED: DEPRECATED: Use cody.permissions instead + // DEPRECATED: Use cody.permissions instead "cody.restrictUsersFeatureFlag": false, // Configuration for Server-side context API @@ -186,11 +187,12 @@ All site configuration options and their default values are shown below. // Disable the feedback survey "disableFeedbackSurvey": false, - // DEPRECATED. Has no effect. + // ⚠️ DEPRECATED: DEPRECATED: This setting has no effect + // DEPRECATED: This setting has no effect "disableNonCriticalTelemetry": false, - // ⚠️ DEPRECATED: Deprecated because it's no longer supported and hasn't been working for a while. - // DEPRECATED! Disable redirects to sourcegraph.com when visiting public repositories that can't exist on this server. + // ⚠️ DEPRECATED: DEPRECATED: This setting has no effect + // DEPRECATED: This setting has no effect // Other example values: // - true "disablePublicRepoRedirects": false, @@ -429,7 +431,8 @@ All site configuration options and their default values are shown below. // Whether or not LSIF uploads will be blocked unless a valid LSIF upload token is provided. "lsifEnforceAuth": false, - // DEPRECATED: Configure maxRepos in search.limits. The maximum number of repositories to search across. The user is prompted to narrow their query if exceeded. Any value less than or equal to zero means unlimited. + // ⚠️ DEPRECATED: DEPRECATED: Configure maxRepos in search.limits + // DEPRECATED: Configure maxRepos in search.limits "maxReposToSearch": -1, "modelConfiguration": null, @@ -929,7 +932,8 @@ All site configuration options and their default values are shown below. // ] "git.cloneURLToRepositoryName": null, - // DEPRECATED: The config options for Sourcegraph GitHub App. + // ⚠️ DEPRECATED: DEPRECATED: Use the GitHub Apps site admin page + // DEPRECATED: Use the GitHub Apps site admin page // Other example values: // - { // "appID": "1234", @@ -986,8 +990,8 @@ All site configuration options and their default values are shown below. "size": 10000 }, - // ⚠️ DEPRECATED: Deprecated because it's no longer supported. Sourcegraph relies on user traffic, webhooks, and heuristics now. - // DEPRECATED: As of Sourcegraph 5.10, this option is no longer in use. Remove this block. + // ⚠️ DEPRECATED: DEPRECATED: As of 5.10, Sourcegraph relies on user traffic, webhooks, and heuristics + // DEPRECATED: As of 5.10, Sourcegraph relies on user traffic, webhooks, and heuristics // Other example values: // - [ // { diff --git a/docs/admin/repo/perforce.mdx b/docs/admin/repo/perforce.mdx index 8bf619a40..f2e42fc44 100644 --- a/docs/admin/repo/perforce.mdx +++ b/docs/admin/repo/perforce.mdx @@ -228,7 +228,7 @@ With this setting, Sourcegraph will ignore any rules with a host other than `*`, {/* SCHEMA_SYNC_START: admin/code_hosts/perforce.schema.json */} {/* WARNING: This section is auto-generated during releases. Do not edit manually. */} -{/* Last updated: 2026-01-08T18:02:22Z */} +{/* Last updated: 2026-01-10T01:42:56Z */} ```json { // If non-null, enforces Perforce depot permissions.