docs: reorganize executor administration and deployment guidance#1818
Open
DaedalusG wants to merge 6 commits into
Open
docs: reorganize executor administration and deployment guidance#1818DaedalusG wants to merge 6 commits into
DaedalusG wants to merge 6 commits into
Conversation
…e config options into their own pages, improve navigation and seperation of concerns
…cerns into its own page
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
bobheadxi
reviewed
Jul 17, 2026
| - [Automatically indexing a repository for precise code navigation](/code-navigation/auto-indexing) | ||
| - [Running batch changes](/batch-changes/server-side) | ||
| - [Automatically index repositories for precise code navigation](/code-navigation/auto-indexing) | ||
| - [Run batch changes server-side](/batch-changes/server-side) |
Member
There was a problem hiding this comment.
Suggested change
| - [Run batch changes server-side](/batch-changes/server-side) | |
| - [Run batch changes server-side](/batch-changes/server-side), including [Agentic Batch Changes](/agentic-batch-changes) |
bobheadxi
reviewed
Jul 17, 2026
| - [Configure code host connections](/admin/code-hosts) for the repositories you want the agent to search and modify. | ||
| - [Configure Batch Changes credentials](/batch-changes/configuring-credentials) for each code host where the agent should publish pull requests or merge requests. | ||
| - [Deploy Sourcegraph executors](/self-hosted/executors/deploy-executors) so Agentic Batch Changes can run code-modification jobs in isolated workspaces. Executors are available with no additional setup on [Sourcegraph Cloud](/cloud). | ||
| - If you use self-hosted Sourcegraph, [deploy Sourcegraph executors](/self-hosted/executors) so Agentic Batch Changes can run code-modification jobs in isolated workspaces. [Sourcegraph Cloud](/cloud) includes Sourcegraph-managed executors by default, so Cloud customers using them do not need to deploy executor infrastructure. |
Member
There was a problem hiding this comment.
You can be in Cloud and have self-hosted executors
Suggested change
| - If you use self-hosted Sourcegraph, [deploy Sourcegraph executors](/self-hosted/executors) so Agentic Batch Changes can run code-modification jobs in isolated workspaces. [Sourcegraph Cloud](/cloud) includes Sourcegraph-managed executors by default, so Cloud customers using them do not need to deploy executor infrastructure. | |
| - Ensure [Sourcegraph executors](/admin/executors) are set up so Agentic Batch Changes can run code-modification jobs in isolated workspaces. [Sourcegraph Cloud](/cloud) includes Sourcegraph-managed executors by default, so Cloud customers using them do not need to deploy executor infrastructure. Otherwise, you will need to [deploy Sourcegraph executors](/self-hosted/executors). |
bobheadxi
reviewed
Jul 18, 2026
| @@ -11,7 +11,7 @@ | |||
|
|
|||
| By default, Batch Changes uses a command line interface in your local environment to [compute diffs](/batch-changes/how-src-executes-a-batch-spec) and create changesets. This can be impractical for creating batch changes affecting hundreds or thousands of repositories, with large numbers of workspaces, or if the batch change steps require CPU, memory, or disk resources that are unavailable locally. | |||
Member
There was a problem hiding this comment.
Is this by default statement true anymore? probably not, right? let's update that while we are here
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes PLAT-790
Summary
This reorganizes the executor documentation around a clearer path from administration concepts to infrastructure deployment and ongoing operations.
admin/executorson executor concepts, Sourcegraph instance setup, authentication, monitoring, secrets, and sandboxing.self-hosted/executorsinto the deployment entry point, with a concise prerequisite checklist, deployment decision guidance, validation, and links to each supported deployment method.deploy-executorscatch-all page, preserves its useful content in the new structure, and adds redirects for its former URLs.Testing
npm run dev.