Minor changes

Author: peterschmidt85

docs/docs/guides/migration/slurm.md

@@ -1,9 +1,14 @@
+---
+title: Migrate from Slurm
+description: This guide compares Slurm and dstack, and shows how to orchestrate equivalent GPU-based workloads using dstack.
+---
+
 # Migrate from Slurm
 
 Both Slurm and `dstack` are open-source workload orchestration systems designed to manage compute resources and schedule jobs. This guide compares Slurm and `dstack`, maps features between the two systems, and shows their `dstack` equivalents.
 
 !!! tip "Slurm vs dstack"
-    Slurm is a battle-tested system with decades of production use in HPC environments. `dstack` is designed for modern ML/AI workloads with cloud-native provisioning and container-first architecture. Slurm is better suited for traditional HPC centers with static clusters; `dstack` is better suited for cloud-native ML teams working with cloud GPUs. Both systems can handle distributed training and batch workloads—the choice depends on your preferences. 
+    Slurm is a battle-tested system with decades of production use in HPC environments. `dstack` is designed for modern ML/AI workloads with cloud-native provisioning and container-first architecture. Slurm is better suited for traditional HPC centers with static clusters; `dstack` is better suited for cloud-native ML teams working with cloud GPUs. Both systems can handle distributed training and batch workloads. 
 
 | | Slurm | dstack |
 |---|-------|--------|
@@ -12,7 +17,7 @@ Both Slurm and `dstack` are open-source workload orchestration systems designed
 | **Use cases** | Batch job scheduling and distributed training | Interactive development, distributed training, and production inference services |
 | **Personas** | HPC centers, academic institutions, research labs | ML engineering teams, AI startups, cloud-native organizations |
 
-While `dstack` is use-case agnostic and natively supports development and production-grade inference, this guide focuses only on training workloads.
+While `dstack` is designed to be use-case agnostic and supports both development and production-grade inference, this guide focuses specifically on training workloads.
 
 ## Architecture
 
@@ -424,7 +429,7 @@ Both systems support core scheduling features and efficient resource utilization
 
 ### Slurm
 
-Slurm may use a multi-factor priority system, and limit usage across accounts, QOS, users, and single runs.
+Slurm may use a multi-factor priority system, and limit usage across accounts, users, and runs.
 
 #### QOS
 
@@ -1837,3 +1842,9 @@ fi
 ### dstack
 
 `dstack` does not support heterogeneous jobs natively. Use separate runs with [workflow orchestration tools (Prefect, Airflow)](#dstack-workflow-orchestration) or submit multiple runs programmatically to coordinate components with different resource requirements.
+
+## What's next?
+
+1. Check out [Quickstart](../../quickstart.md)
+2. Read about [dev environments](../../concepts/dev-environments.md), [tasks](../../concepts/tasks.md), and [services](../../concepts/services.md)
+3. Browse the [examples](../../../examples.md)

docs/layouts/custom.yml

@@ -50,12 +50,12 @@ size: { width: 1200, height: 630 }
 layers:
   - background:
       color: "black"
-  - size: { width: 50, height: 50 }
-    offset: { x: 935, y: 521 }
+  - size: { width: 65, height: 60 }
+    offset: { x: 908, y: 499 }
     background:
       image: *logo
-  - size: { width: 340, height: 55 }
-    offset: { x: 993, y: 521 }
+  - size: { width: 360, height: 59 }
+    offset: { x: 975, y: 502 }
     typography:
       content: *site_name
       color: "white"
@@ -69,15 +69,15 @@ layers:
       line:
         amount: 3
         height: 1.25
-  # - size: { width: 850, height: 64 }
-  #   offset: { x: 80, y: 495 }
-  #   typography:
-  #     content: *page_description
-  #     align: start
-  #     color: "white"
-  #     line:
-  #       amount: 2
-  #       height: 1.5
+  - size: { width: 870, height: 64 }
+    offset: { x: 80, y: 498 }
+    typography:
+      content: *page_description
+      align: start
+      color: "white"
+      line:
+        amount: 2
+        height: 1.5
 
 tags:
 

mkdocs.yml

@@ -3,7 +3,7 @@ site_name: dstack
 site_url: https://dstack.ai
 site_author: dstack GmbH
 site_description: >-
-  dstack is an open-source control plane for running development, training, and inference jobs on GPUs - across hyperscalers, neoclouds, or on-prem.
+  dstack is an open-source control plane for GPU provisioning and orchestration across GPU clouds, Kubernetes, and on-prem clusters.
 
 # Repository
 repo_url: https://github.com/dstackai/dstack
@@ -279,8 +279,8 @@ nav:
           - Metrics: docs/guides/metrics.md
           - Protips: docs/guides/protips.md
           - Upgrade: docs/guides/upgrade.md
-          - Migration:
-              - Slurm: docs/guides/migration/slurm.md
+      - Migration:
+        - Slurm: docs/guides/migration/slurm.md
       - Reference:
           - .dstack.yml:
               - dev-environment: docs/reference/dstack.yml/dev-environment.md