Skip to content

[Docs] Amplify the main use-cases for tasks and services (WIP) - #4260

Draft
peterschmidt85 wants to merge 3 commits into
masterfrom
docs-tasks-services-use-cases
Draft

[Docs] Amplify the main use-cases for tasks and services (WIP)#4260
peterschmidt85 wants to merge 3 commits into
masterfrom
docs-tasks-services-use-cases

Conversation

@peterschmidt85

@peterschmidt85 peterschmidt85 commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

Amplifies the main use-cases on the Tasks and Services concept pages.

Tasks

Nodes and Node groups lead the page. Node groups is nested under Nodes, and the router-and-workers example is reframed as "Prototyping services" with a pointer to the dstack-prototyping skill.

"Distributed tasks" are now called "multi-node tasks" across the docs, blog posts, and the dstack skill, matching the Nodes section. "Distributed training" is unchanged.

Services

replicas is made explicit in the main example, and Replica groups (router, PD disaggregation) is the only replica section, since a router is what production inference needs.

Minor

  • Configuration options subsections follow the same order on both pages
  • Retry policy and Ports are top-level on Tasks, Gateway on Services
  • Quickstart mentions node groups for tasks, and replicas and replica groups for services
  • Links to the removed Distributed tasks and Replicas and scaling sections point to their replacements
  • Old links to tasks#distributed-tasks and services#replicas-and-scaling keep working via compatibility anchors

TODO

  • Finish TODOs in "Prototyping services" in Tasks (Node groups)
  • Finish TODOs in "Replica groups" in Services
  • Finish TODOs in "Scaling" in Services

🤖 Generated with Claude Code

Andrey Cheptsov and others added 3 commits September 4, 2026 13:50
Tasks: Nodes and Node groups lead the page; Node groups nested under
Nodes; router-and-workers example reframed as "Prototyping services".

Services: replicas made explicit in the main example; Replica groups
(router, PD disaggregation) is the only replica section.

Minor: same Configuration options order on both pages; Retry policy and
Ports top-level on Tasks, Gateway on Services; fix dead
#replicas-and-scaling anchor.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Rename "distributed task" to "multi-node task" across docs and the
dstack skill to match the Nodes section; keep "distributed training".

Point links to the removed sections at their replacements: #nodes,
#replica-groups, #scaling, #router.

Quickstart: mention node groups for tasks and add the matching replicas
and replica groups sentence for services.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…rking

Apply the multi-node task rename to blog posts. Add compatibility anchors
so links to tasks#distributed-tasks and services#replicas-and-scaling
still land on the right section.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant