Skip to content

docs: update CLI reference and troubleshooting for board and actionable errors#3494

Merged
dgageot merged 2 commits into
mainfrom
docs/auto-update
Jul 7, 2026
Merged

docs: update CLI reference and troubleshooting for board and actionable errors#3494
dgageot merged 2 commits into
mainfrom
docs/auto-update

Conversation

@aheritier

Copy link
Copy Markdown
Contributor

Summary

Catches two documentation gaps from PRs merged in the last 36 hours.

Changes

  • docker agent board CLI reference (docs/features/cli/index.md): PR feat: add docker agent board, a Kanban TUI for orchestrating agents #3451 shipped a full feature page for the new Kanban board but omitted the command from the master CLI reference. This commit adds the docker agent board section with its usage, requirements, and a link to the feature page.

  • Actionable model/credential errors (docs/community/troubleshooting/index.md): PR feat(cli): actionable errors for missing models and credentials (phase 1 of #3442) #3452 introduced clear, actionable error messages when model credentials are missing or Docker Model Runner is unreachable. No documentation was written at the time. This commit adds a troubleshooting section covering those three scenarios with example error text and a docker agent doctor diagnosis tip.

Source PRs

Reviewer notes

Two low-severity/low-confidence style findings were raised and deliberately left as-is:

  • Placement of docker agent board: reviewer suggested grouping it with other top-level commands (before serve). Placed after serve chat per the explicit task spec.
  • Windows caveat: docker agent board doesn't work on Windows (no tmux). The feature page at docs/features/board/index.md notes only "Requires tmux and git"; the CLI reference mirrors that same level of detail for consistency.

aheritier added 2 commits July 7, 2026 04:08
Adds the missing `docker agent board` section to the CLI reference.

Source: #3451
…and credentials

Adds a troubleshooting section covering the new error messages fired when
model credentials are absent or DMR is unreachable, directing users to
`docker agent doctor` for diagnosis.

Source: #3452
@aheritier aheritier requested a review from a team as a code owner July 7, 2026 04:15
@aheritier aheritier added kind/docs Documentation-only changes area/docs Documentation changes labels Jul 7, 2026
@dgageot dgageot merged commit 9a07adc into main Jul 7, 2026
18 checks passed
@dgageot dgageot deleted the docs/auto-update branch July 7, 2026 05:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Documentation changes kind/docs Documentation-only changes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants