docs: close Coder Agents coverage gaps and align nav references#24971
Merged
Conversation
Fix nav references that no longer match the Settings sidebar in the Agents page after the Behavior page split (#24574) and Insights nav removal (#24644). - Plan mode instructions: Behavior -> Instructions - Workspace autostop fallback: Behavior -> Lifecycle - Data retention: Behavior -> Lifecycle - System prompt: add explicit Settings > Instructions path - Add provider, Add model, system prompt config: replace removed "Admin" top-bar dialog with Settings panel - Personal model overrides: drop redundant 'Manage Agents' hop and match the convention used by sibling docs - PR Insights: note that the page is no longer linked from the sidebar and is reachable only by direct URL or API - Image alt text and 'Admin panel' phrasing updated to match the current Settings panel name
Docs preview📖 View docs preview for |
Remove the PR Insights page and references to it from sibling docs and the manifest. The dashboard at /agents/settings/insights is no longer linked from any UI surface and the page is being retired.
…l features into one page Replace the standalone Advisor page and the two experimental sections in index.md with a single Experiments page. The new page follows the Experiments tab in Settings and covers Virtual desktop, Advisor, and Chat debug logging in short, parallel sections. The index page now has one Experiments pointer instead of three sections inline, matching how sibling experimental docs are surfaced elsewhere.
…y tabs Insert the 'Manage Agents' sub-panel into every nav reference that points to an admin-only Settings tab. The Settings sidebar puts Agents, Providers, Models, MCP Servers, Templates, Spend, Instructions, Experiments, and Lifecycle behind a 'Manage Agents' drilldown, so the short form 'Settings > <admin-tab>' was understating one click. User-side tabs (General, Agents personal overrides, Compaction, Secrets/ API Keys) keep the short form since they sit at the top of the Settings panel.
mattvollmer
commented
May 5, 2026
… panel The right panel on the Agents page shows a Debug tab when debug logging is active for the chat. Earlier text claimed there was no dashboard viewer; correct that and keep the API reference for programmatic use.
mattvollmer
commented
May 5, 2026
mattvollmer
commented
May 5, 2026
mattvollmer
commented
May 5, 2026
mattvollmer
commented
May 5, 2026
mattvollmer
commented
May 5, 2026
…d and experiments Addresses review comments on PR #24971: - getting-started.md: drop the upgrade-backfill note (it's noise for new installs; the migration handles it transparently). - getting-started.md: rework the CLI section. The `edit-roles` command replaces the user's full org role set, not append to it, so the prior examples would silently drop other org roles. Replace with examples that fetch the current roles, add `agents-access`, and write the union back. - getting-started.md: spell out the navigation path for per-model token pricing ("Manage Agents > Models"). - platform-controls/index.md: drop the inline list of current experiments. The "See Experiments" link is the source of truth, so this section doesn't need to be kept in sync. - architecture.md: link the `spawn_agent` (`type=computer_use`) row to the virtual desktop experiment so users can see how to enable it.
…rage-gaps # Conflicts: # docs/ai-coder/agents/architecture.md # docs/ai-coder/agents/platform-controls/index.md
The previous section was a near-complete API reference that mostly repeated what the experimental chat configuration API already documents. For the getting-started narrative, keep: - The two override layers (admin subagent, user personal) and where to find them in the UI. - The configurable contexts in one table. - The resolution order in three lines. - A pointer to the experimental config API. Drop the per-endpoint URLs, request/response shapes, error codes, and mode-resolution mechanics. Anyone wiring this up programmatically should read the API definition rather than the docs page.
ibetitsmike
approved these changes
May 5, 2026
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
3 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 coverage gaps in
docs/ai-coder/agents/and aligns nav references with the current UI (post #24574 Behavior split, post #24644 Insights removal).Content fixes:
coder users edit-rolesflow with org-scopedagents-accessrole (per migration000475). CLI examples now preserve existing org roles sinceedit-rolesoverwrites the full set.platform-controls/experiments.mdcovering Virtual desktop, Advisor, and Chat debug logging (each as: what, how to enable, API). Includes the Debug tab in the chat right panel.models.md"Model overrides" to essentials: two layers (admin subagent, user personal), contexts table, resolution order, API pointer.platform-controls/pr-insights.md(page + manifest + cross-links).Nav cleanup:
Agents > Settings > Manage Agents > <Tab>path; user-side tabs keepAgents > Settings > <Tab>.Decision log
platform-controls/index.md. Consolidated into oneexperiments.mdsince no individual feature warrants a full page yet and parallel short sections are easier to scan.index.md(avoid drift), drop the "users created before this role was introduced" note (handled transparently by migration000475), specify the full nav path for per-model pricing, link thetype=computer_userow inarchitecture.mdto the Experiments page.edit-roles <user> agents-access. That replaces the user's full org role set, so the script would silently striporganization-admin,organization-template-admin, etc. Rewrote to read each user's current roles, appendagents-access, dedupe, and write the union back.PR generated with Coder Agents.