-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Description
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