Skip to content

[docs-scanner] Inconsistent task state names between services.md and swarm-task-states.md #24464

@docker-agent

Description

@docker-agent

File: content/manuals/engine/swarm/how-swarm-mode-works/services.md

Issue

The services.md file describes task states using informal names that don't match the actual state names documented in the sibling file swarm-task-states.md:

In services.md:

A task is a one-directional mechanism. It progresses monotonically through a series of states: assigned, prepared, running, etc.

However, swarm-task-states.md documents the actual states as: NEW, PENDING, ASSIGNED, ACCEPTED, READY, PREPARING, STARTING, RUNNING, COMPLETE, FAILED, SHUTDOWN, REJECTED, ORPHANED, REMOVE.

The term "prepared" in services.md doesn't match any actual state name. The closest actual state is PREPARING. This creates a sibling contradiction where two pages in the same directory give conflicting information about task states.

Suggested fix

Update services.md to use the actual state names or clarify that these are simplified examples:

A task is a one-directional mechanism. It progresses monotonically through a series of states: `ASSIGNED`, `PREPARING`, `RUNNING`, etc.

Or add a qualifier:

A task is a one-directional mechanism. It progresses monotonically through a series of states such as assigned, preparing, and running.

Found by nightly documentation freshness scanner

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions