[Docs] Minor edits on the landing page, in README, and Quickstart (#3129)

peterschmidt85 · web-flow · commit 8a6bcd40b14d · 2025-09-24T13:18:35.000+02:00
diff --git a/README.md b/README.md
@@ -14,26 +14,28 @@
 
 </div>
 
-`dstack` is an open-source container orchestrator that simplifies workload orchestration and drives GPU utilization for ML teams. It works with any GPU cloud, on-prem cluster, or accelerated hardware.
+`dstack` provides a unified control plane for running development, training, and inference on GPUs — across cloud VMs, Kubernetes, or on-prem clusters. It helps your team avoid vendor lock-in and reduce GPU costs.
 
 #### Accelerators
 
 `dstack` supports `NVIDIA`, `AMD`, `Google TPU`, `Intel Gaudi`, and `Tenstorrent` accelerators out of the box.
 
 ## Latest news ✨
+- [2025/09] [dstack 0.19.27: Offers UI, Digital Ocean and AMD Developer Cloud](https://github.com/dstackai/dstack/releases/tag/0.19.27)
+- [2025/08] [dstack 0.19.26: Repos – explicit repo configuration via YAML](https://github.com/dstackai/dstack/releases/tag/0.19.26)
+- [2025/08] [dstack 0.19.25: `dstack offer` CLI command](https://github.com/dstackai/dstack/releases/tag/0.19.25)
+- [2025/08] [dstack 0.19.22: Service probes, GPU health-checks, Tenstorrent Galaxy, Secrets UI](https://github.com/dstackai/dstack/releases/tag/0.19.22)
+- [2025/07] [dstack 0.19.21: Scheduled tasks](https://github.com/dstackai/dstack/releases/tag/0.19.21)
 - [2025/07] [dstack 0.19.17: Secrets, Files, Rolling deployment](https://github.com/dstackai/dstack/releases/tag/0.19.17)
 - [2025/06] [dstack 0.19.16: Docker in Docker, CloudRift](https://github.com/dstackai/dstack/releases/tag/0.19.16)
 - [2025/06] [dstack 0.19.13: InfiniBand support in default images](https://github.com/dstackai/dstack/releases/tag/0.19.13)
 - [2025/06] [dstack 0.19.12: Simplified use of MPI](https://github.com/dstackai/dstack/releases/tag/0.19.12)
-- [2025/05] [dstack 0.19.10: Priorities](https://github.com/dstackai/dstack/releases/tag/0.19.10)
-- [2025/05] [dstack 0.19.8: Nebius clusters, GH200 on Lambda](https://github.com/dstackai/dstack/releases/tag/0.19.8)
-- [2025/04] [dstack 0.19.6: Tenstorrent, Plugins](https://github.com/dstackai/dstack/releases/tag/0.19.6)
 
 ## How does it work?
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://dstack.ai/static-assets/static-assets/images/dstack-architecture-diagram-v10-dark.svg"/>
-  <img src="https://dstack.ai/static-assets/static-assets/images/dstack-architecture-diagram-v10.svg" width="750" />
+  <source media="(prefers-color-scheme: dark)" srcset="https://dstack.ai/static-assets/static-assets/images/dstack-architecture-diagram-v11-dark.svg"/>
+  <img src="https://dstack.ai/static-assets/static-assets/images/dstack-architecture-diagram-v11.svg" width="750" />
 </picture>
 
 ### Installation
diff --git a/docs/assets/stylesheets/landing.css b/docs/assets/stylesheets/landing.css
@@ -11,7 +11,7 @@
 }
 
 .tx-landing__hero_text h1 {
-    margin-bottom: .75rem;
+    margin-bottom: .6rem;
     font-weight: 700;
     font-size: 2.5em;
     /*letter-spacing: -3px;*/
@@ -239,7 +239,7 @@
 
 .md-header__buttons .md-button,
 .md-typeset .md-button {
-    margin-top: 1.2rem;
+    margin-top: 0.6rem;
     margin-bottom: 1.5rem;
     font-size: 19px;
     font-weight: 300 !important;
diff --git a/docs/docs/quickstart.md b/docs/docs/quickstart.md
@@ -14,9 +14,9 @@ $ mkdir quickstart && cd quickstart
 
 </div>
 
-## Run your first workload
+## Submit your first run
 
-`dstack` supports three types of workloads.
+`dstack` supports three types of run configurations.
 
 === "Dev environment"
 
diff --git a/docs/overrides/header-2.html b/docs/overrides/header-2.html
@@ -62,7 +62,7 @@
 
     <div class="md-header__buttons">
       <a href="https://github.com/dstackai/dstack" target="_blank" class="md-button md-button--primary github">GitHub</a>
-      <a href="https://sky.dstack.ai" target="_blank" class="md-button md-button--primary sky external">Sign up</a>
+      <a href="https://sky.dstack.ai" target="_blank" class="md-button md-button--primary sky">dstack Sky</a>
     </div>
   </nav>
   {% if "navigation.tabs.sticky" in features %}
diff --git a/docs/overrides/home.html b/docs/overrides/home.html
@@ -53,8 +53,9 @@
                 <h1>The orchestration layer for modern ML teams</h1>
 
                 <p>
-                    <span class="highlight">dstack</span> gives your team a single control plane to run development, training, and inference
-                    jobs on GPU—whether on hyperscalers, neoclouds, or your on-prem hardware. Avoid vendor lock-in and minimize GPU spend.
+                    <span class="highlight">dstack</span> provides a unified control plane for running development, training, and inference
+                    on GPUs — across cloud VMs, Kubernetes, or on-prem clusters. It helps your team avoid vendor lock-in and reduce GPU
+                    costs.
                 </p>
             </div>
 
@@ -74,8 +75,8 @@ <h1>The orchestration layer for modern ML teams</h1>
                     </a>
                 </div>
             </div>
-            <div class="tx-landing__hero_button_container_text" style="text-align: center; font-size: 85%; margin-top: 25px;">
-                The entire setup takes minutes.
+            <div class="tx-landing__hero_button_container_text" style="text-align: center; font-size: 85%; margin-top: 1.25rem">
+                Open-source self-hosted or fully-managed. Setup takes a few minutes.
             </div>
         </div>
 
@@ -103,7 +104,7 @@ <h2>One control plane for all your GPUs</h2>
                 </div>
 
                 <div class="block large">
-                    <img src="https://dstack.ai/static-assets/static-assets/images/dstack-architecture-diagram-v10.svg" />
+                    <img src="https://dstack.ai/static-assets/static-assets/images/dstack-architecture-diagram-v11.svg" />
                 </div>
             </div>
         </div>
@@ -163,21 +164,33 @@ <h2>One control plane for all your GPUs</h2>
                 </div>
 
                 <div class="block margin">
-                    <h2>Run on any cloud. Or all of them.</h2>
+                    <h2>Native integration with GPU clouds</h2>
                     <p>
-                        <span class="highlight">dstack</span> natively provisions GPU instances and clusters across your preferred cloud
-                        providers—maximizing efficiency and minimizing overhead.
+                        <span class="highlight">dstack</span> natively integrates with top GPU clouds—automating cluster provisioning and
+                        workload orchestration to maximize efficiency and minimize overhead.
                     </p>
                     
                     <p>
-                        Connect GPU clouds directly to <span class="highlight">dstack</span> natively, or run <span class="highlight">dstack</span> on top of Kubernetes if needed.
+                        It can provision and manage VM clusters through native integrations or via <span class="highlight">Kuberenetes</span>.
                     </p>
 
                     <p>
-                        <a href="/docs/concepts/backends" target="_blank"
-                            class="md-button md-button-secondary small">
+                        <a href="/docs/concepts/backends" target="_blank" class="md-button md-button-secondary small">
                             <span>Backends</span>
-                            <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg"><path d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z" fill-rule="nonzero" fill="currentColor" class="fill-main"></path></svg></span>
+                            <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg">
+                                    <path
+                                        d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z"
+                                        fill-rule="nonzero" fill="currentColor" class="fill-main"></path>
+                                </svg></span>
+                        </a>
+
+                        <a href="/docs/concepts/backends#kubernetes" target="_blank" class="md-button md-button-secondary small">
+                            <span>Kubernetes</span>
+                            <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg">
+                                    <path
+                                        d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z"
+                                        fill-rule="nonzero" fill="currentColor" class="fill-main"></path>
+                                </svg></span>
                         </a>
                     </p>
                 </div>
@@ -187,25 +200,38 @@ <h2>Run on any cloud. Or all of them.</h2>
         <div class="tx-landing__major_feature">
             <div class="section">
                 <div class="block margin right">
-                    <h2>Bring your own compute</h2>
-
+                    <h2>Easy to use with on-prem clusters</h2>
+                    
                     <p>
-                        Have bare-metal servers or on-prem GPU clusters? <span class="highlight">dstack</span> makes it easy to integrate them
-                        and manage everything alongside your cloud resources.
+                        For provisioned <span class="highlight">Kuberenetes</span> clusters, connect them to <span class="highlight">dstack</span> using the <span
+                            class="highlight">Kubernetes</span> backend.
+                        If you run vanilla bare-metal servers or VMs without <span class="highlight">Kuberenetes</span>, use <span class="highlight">SSH fleets</span>
+                        instead.
                     </p>
                     
-                    <p>With SSH fleets, you can connect any existing cluster in minutes. Once added to <span
-                            class="highlight">dstack</span>, it's a first-class resource &mdash; available for dev environments, tasks, and
-                        services.
-                    </p>
-
                     <p>
-                        <a href="/docs/concepts/fleets#ssh" target="_blank"
-                            class="md-button md-button-secondary small">
+                        <a href="/docs/concepts/backends#kubernetes" target="_blank" class="md-button md-button-secondary small">
+                            <span>Kubernetes</span>
+                            <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg">
+                                    <path
+                                        d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z"
+                                        fill-rule="nonzero" fill="currentColor" class="fill-main"></path>
+                                </svg></span>
+                        </a>
+                    
+                        <a href="/docs/concepts/fleets#ssh" target="_blank" class="md-button md-button-secondary small">
                             <span>SSH fleets</span>
-                            <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg"><path d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z" fill-rule="nonzero" fill="currentColor" class="fill-main"></path></svg></span>
+                            <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg">
+                                    <path
+                                        d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z"
+                                        fill-rule="nonzero" fill="currentColor" class="fill-main"></path>
+                                </svg></span>
                         </a>
                     </p>
+                    
+                    <p>
+                        Either way, connecting existing on-prem clusters to <span class="highlight">dstack</span> takes just minutes.
+                    </p>
                 </div>
 
                 <div class="block large">
@@ -224,7 +250,7 @@ <h2>Bring your own compute</h2>
                 </div>
 
                 <div class="block margin left">
-                    <h2>Code locally, run remotely</h2>
+                    <h2>Dev environments</h2>
                     <p>
                         Before training or deployment, ML engineers explore and debug their code.
                     </p>
@@ -247,7 +273,7 @@ <h2>Code locally, run remotely</h2>
         <div class="tx-landing__major_feature">
             <div class="section">
                 <div class="block margin right">
-                    <h2>Run complex training with simple config</h2>
+                    <h2>Single-node &amp; distributed tasks</h2>
 
                     <p>
                         Move from single-instance experiments to multi-node distributed training without friction. <span
@@ -263,6 +289,12 @@ <h2>Run complex training with simple config</h2>
                             <span>Tasks</span>
                             <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg"><path d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z" fill-rule="nonzero" fill="currentColor" class="fill-main"></path></svg></span>
                         </a>
+
+                        <a href="/docs/guides/clusters" target="_blank"
+                            class="md-button md-button-secondary small">
+                            <span>Clusters</span>
+                            <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg"><path d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z" fill-rule="nonzero" fill="currentColor" class="fill-main"></path></svg></span>
+                        </a>
                     </p>
                 </div>
 
@@ -281,7 +313,7 @@ <h2>Run complex training with simple config</h2>
                 </div>
 
                 <div class="block margin left">
-                    <h2>Deploy scalable, OpenAI-compatible endpoints</h2>
+                    <h2>Scalable service endpoints</h2>
 
                     <p>
                         With <span class="highlight">dstack</span>, you can easily deploy any model as a secure,
@@ -518,17 +550,17 @@ <h2>Get started in minutes</h2>
                     <p>Set up backends or SSH fleets, then add your team.</p>
 
                     <p>
-                        <a href="/docs/installation" target="_blank"
-                           class="md-button md-button--primary small"
+                        <a href="/docs/quickstart" target="_blank"
+                           class="md-button md-button-secondary small"
                             style="margin-right: 10px">
-                            <span>Installation</span>
+                            <span>Quickstart</span>
                             <span class="icon"><svg viewBox="0 0 13 10" xmlns="http://www.w3.org/2000/svg"><path d="M12.823 4.164L8.954.182a.592.592 0 0 0-.854 0 .635.635 0 0 0 0 .88l2.836 2.92H.604A.614.614 0 0 0 0 4.604c0 .344.27.622.604.622h10.332L8.1 8.146a.635.635 0 0 0 0 .88.594.594 0 0 0 .854 0l3.869-3.982a.635.635 0 0 0 0-.88z" fill-rule="nonzero" fill="currentColor" class="fill-main"></path></svg></span>
                         </a>
 
-                        <a href="/docs/quickstart" target="_blank" class="md-button md-button-secondary small"
+                        <!-- <a href="/docs/quickstart" target="_blank" class="md-button md-button-secondary small"
                            style="">
                             Quickstart
-                        </a>
+                        </a> -->
                     </p>
                 </div>
 
@@ -559,7 +591,7 @@ <h2>dstack Sky</h2>
                         </div>
 
                         <div class="tx-landing__bottom_cta_card_button_subheader">
-                            Already have an account? <a href="https://sky.dstack.ai" target="_blank"
+                            Get $5 free credit. Already have an account? <a href="https://sky.dstack.ai" target="_blank"
                                 class="tx-footer__section-link external">Sign in</a>
                         </div>
                     </div>
@@ -578,7 +610,7 @@ <h2>dstack Enterprise</h2>
                         <div>
                             <a href="https://calendly.com/dstackai/discovery-call" target="_blank"
                                 class="md-button md-button--primary external small">
-                                <span>Get a demo</span>
+                                <span>Book a demo</span>
                             </a>
                         </div>
 
