From cea4a3ae10c8e7daf84d03de7baa75ae7e981813 Mon Sep 17 00:00:00 2001 From: peterschmidt85 Date: Thu, 3 Jul 2025 13:22:04 +0200 Subject: [PATCH 1/2] [Docs] Refactoring - [x] Replaced `Blog` in the top menu with `Benchmarks` and `Case studies` - [x] Refactored blog categories - [x] Minor edits --- docs/assets/stylesheets/extra.css | 8 ++++++-- docs/blog/posts/amd-mi300x-inference-benchmark.md | 1 - docs/blog/posts/amd-on-runpod.md | 2 +- docs/blog/posts/amd-on-tensorwave.md | 3 +-- ...beyond-kubernetes-2024-recap-and-whats-ahead.md | 6 ------ docs/blog/posts/cursor.md | 2 +- docs/blog/posts/dstack-metrics.md | 4 +--- docs/blog/posts/dstack-sky-own-cloud-accounts.md | 2 ++ docs/blog/posts/dstack-sky.md | 2 ++ docs/blog/posts/ea-gtc25.md | 5 +++-- docs/blog/posts/gh200-on-lambda.md | 4 +--- docs/blog/posts/gpu-blocks-and-proxy-jump.md | 2 +- docs/blog/posts/h100-mi300x-inference-benchmark.md | 2 -- docs/blog/posts/h200-mi300x-deepskeek-benchmark.md | 2 -- docs/blog/posts/inactivity-duration.md | 2 +- docs/blog/posts/instance-volumes.md | 2 +- docs/blog/posts/intel-gaudi.md | 3 +-- docs/blog/posts/metrics-ui.md | 4 +--- docs/blog/posts/mpi.md | 3 +-- docs/blog/posts/nebius.md | 3 +-- docs/blog/posts/nvidia-and-amd-on-vultr.md | 4 +--- docs/blog/posts/prometheus.md | 3 +-- docs/blog/posts/tpu-on-gcp.md | 2 +- docs/blog/posts/volumes-on-runpod.md | 2 +- mkdocs.yml | 14 ++++++++------ 25 files changed, 37 insertions(+), 50 deletions(-) diff --git a/docs/assets/stylesheets/extra.css b/docs/assets/stylesheets/extra.css index 928fafb7f3..82e80e658a 100644 --- a/docs/assets/stylesheets/extra.css +++ b/docs/assets/stylesheets/extra.css @@ -1318,14 +1318,18 @@ html .md-footer-meta.md-typeset a:is(:focus,:hover) { display: none; } - .md-tabs__item:nth-child(5):after { + .md-tabs__item:nth-child(6) { + display: none; + } + + /* .md-tabs__item:nth-child(5):after { content: url('data:image/svg+xml,'); line-height: 14px; margin-left: 4px; position: relative; top: 16px; margin-right: -7px; - } + } */ /*.md-tabs__item:nth-child(6) { margin-left: auto; diff --git a/docs/blog/posts/amd-mi300x-inference-benchmark.md b/docs/blog/posts/amd-mi300x-inference-benchmark.md index 0e503bf29d..1aab93b8b8 100644 --- a/docs/blog/posts/amd-mi300x-inference-benchmark.md +++ b/docs/blog/posts/amd-mi300x-inference-benchmark.md @@ -5,7 +5,6 @@ description: "Exploring how the inference performance of Llama 3.1 405B varies o slug: amd-mi300x-inference-benchmark image: https://dstack.ai/static-assets/static-assets/images/dstack-hotaisle-amd-mi300x-prompt-v5.png categories: - - AMD - Benchmarks --- diff --git a/docs/blog/posts/amd-on-runpod.md b/docs/blog/posts/amd-on-runpod.md index eb4668e506..d9d948cf62 100644 --- a/docs/blog/posts/amd-on-runpod.md +++ b/docs/blog/posts/amd-on-runpod.md @@ -4,7 +4,7 @@ date: 2024-08-21 description: "dstack, the open-source AI container orchestration platform, adds support for AMD accelerators, with RunPod as the first supported cloud provider." slug: amd-on-runpod categories: - - AMD + - Releases --- # Supporting AMD accelerators on RunPod diff --git a/docs/blog/posts/amd-on-tensorwave.md b/docs/blog/posts/amd-on-tensorwave.md index 1a9d77333e..52d153bed8 100644 --- a/docs/blog/posts/amd-on-tensorwave.md +++ b/docs/blog/posts/amd-on-tensorwave.md @@ -5,8 +5,7 @@ description: "This tutorial walks you through how dstack can be used with Tensor slug: amd-on-tensorwave image: https://dstack.ai/static-assets/static-assets/images/dstack-tensorwave-v2.png categories: - - AMD - - SSH fleets + - Case studies --- # Using SSH fleets with TensorWave's private AMD cloud diff --git a/docs/blog/posts/beyond-kubernetes-2024-recap-and-whats-ahead.md b/docs/blog/posts/beyond-kubernetes-2024-recap-and-whats-ahead.md index 79e026a0b4..dec4945ed5 100644 --- a/docs/blog/posts/beyond-kubernetes-2024-recap-and-whats-ahead.md +++ b/docs/blog/posts/beyond-kubernetes-2024-recap-and-whats-ahead.md @@ -4,12 +4,6 @@ date: 2024-12-10 description: "Reflecting on key milestones from 2024, and looking ahead to the next steps in simplifying AI infrastructure orchestration." slug: beyond-kubernetes-2024-recap-and-whats-ahead image: https://dstack.ai/static-assets/static-assets/images/beyond-kubernetes-2024-recap-and-whats-ahead.png -categories: - - AMD - - NVIDIA - - Volumes - - Cloud fleets - - SSH fleets --- # Beyond Kubernetes: 2024 recap and what's ahead for AI infra diff --git a/docs/blog/posts/cursor.md b/docs/blog/posts/cursor.md index 3b1b0f7a57..bdc1e4a619 100644 --- a/docs/blog/posts/cursor.md +++ b/docs/blog/posts/cursor.md @@ -5,7 +5,7 @@ description: "TBA" slug: cursor image: https://dstack.ai/static-assets/static-assets/images/dstack-cursor-v2.png categories: - - Dev environments + - Releases --- # Accessing dev environments with Cursor diff --git a/docs/blog/posts/dstack-metrics.md b/docs/blog/posts/dstack-metrics.md index 07d80ab0ab..f06ff31515 100644 --- a/docs/blog/posts/dstack-metrics.md +++ b/docs/blog/posts/dstack-metrics.md @@ -5,9 +5,7 @@ description: "dstack introduces a new CLI command (and API) for monitoring conta slug: dstack-metrics image: https://dstack.ai/static-assets/static-assets/images/dstack-stats-v2.png categories: - - AMD - - NVIDIA - - Metrics + - Releases --- # Monitoring essential GPU metrics via CLI diff --git a/docs/blog/posts/dstack-sky-own-cloud-accounts.md b/docs/blog/posts/dstack-sky-own-cloud-accounts.md index 738c416db7..ff0b8d1826 100644 --- a/docs/blog/posts/dstack-sky-own-cloud-accounts.md +++ b/docs/blog/posts/dstack-sky-own-cloud-accounts.md @@ -3,6 +3,8 @@ title: dstack Sky now supports your own cloud accounts date: 2024-06-11 description: "With today's release, dstack Sky supports both options: accessing the GPU marketplace and using your own cloud accounts." slug: dstack-sky-own-cloud-accounts +categories: + - Releases --- # dstack Sky now supports your own cloud accounts diff --git a/docs/blog/posts/dstack-sky.md b/docs/blog/posts/dstack-sky.md index 9b04f9ab7f..7cfe800970 100644 --- a/docs/blog/posts/dstack-sky.md +++ b/docs/blog/posts/dstack-sky.md @@ -2,6 +2,8 @@ date: 2024-03-11 description: A managed service that enables you to get GPUs at competitive rates from a wide pool of providers. slug: dstack-sky +categories: + - Releases --- # Introducing dstack Sky diff --git a/docs/blog/posts/ea-gtc25.md b/docs/blog/posts/ea-gtc25.md index fe4b8414b5..262554866b 100644 --- a/docs/blog/posts/ea-gtc25.md +++ b/docs/blog/posts/ea-gtc25.md @@ -6,10 +6,11 @@ slug: ea-gtc25 image: https://dstack.ai/static-assets/static-assets/images/dstack-ea-slide-2-background-min.png categories: - Case studies - - NVIDIA +links: + - NVIDIA GTC 2025 ↗: https://www.nvidia.com/en-us/on-demand/session/gtc25-s73667/ --- -# Case study: how EA uses dstack to fast-track AI development +# How EA uses dstack to fast-track AI development At NVIDIA GTC 2025, Electronic Arts [shared :material-arrow-top-right-thin:{ .external }](https://www.nvidia.com/en-us/on-demand/session/gtc25-s73667/){:target="_blank"} how they’re scaling AI development and managing infrastructure across teams. They highlighted using tools like `dstack` to provision GPUs quickly, flexibly, and cost-efficiently. This case study summarizes key insights from their talk. diff --git a/docs/blog/posts/gh200-on-lambda.md b/docs/blog/posts/gh200-on-lambda.md index b335731c97..970c87b12f 100644 --- a/docs/blog/posts/gh200-on-lambda.md +++ b/docs/blog/posts/gh200-on-lambda.md @@ -5,9 +5,7 @@ description: "TBA" slug: gh200-on-lambda image: https://dstack.ai/static-assets/static-assets/images/dstack-arm--gh200-lambda-min.png categories: - - ARM - - Cloud fleets - - SSH fleets + - Releases --- # Supporting ARM and NVIDIA GH200 on Lambda diff --git a/docs/blog/posts/gpu-blocks-and-proxy-jump.md b/docs/blog/posts/gpu-blocks-and-proxy-jump.md index c0ef1bacc1..dc8bea1dfc 100644 --- a/docs/blog/posts/gpu-blocks-and-proxy-jump.md +++ b/docs/blog/posts/gpu-blocks-and-proxy-jump.md @@ -5,7 +5,7 @@ description: "TBA" slug: gpu-blocks-and-proxy-jump image: https://dstack.ai/static-assets/static-assets/images/data-centers-and-private-clouds.png categories: - - SSH fleets + - Releases --- # Introducing GPU blocks and proxy jump for SSH fleets diff --git a/docs/blog/posts/h100-mi300x-inference-benchmark.md b/docs/blog/posts/h100-mi300x-inference-benchmark.md index 2a9db54526..3507956840 100644 --- a/docs/blog/posts/h100-mi300x-inference-benchmark.md +++ b/docs/blog/posts/h100-mi300x-inference-benchmark.md @@ -6,8 +6,6 @@ slug: h100-mi300x-inference-benchmark image: https://dstack.ai/static-assets/static-assets/images/h100-mi300x-inference-benchmark-v2.png categories: - Benchmarks - - AMD - - NVIDIA --- # Exploring inference memory saturation effect: H100 vs MI300x diff --git a/docs/blog/posts/h200-mi300x-deepskeek-benchmark.md b/docs/blog/posts/h200-mi300x-deepskeek-benchmark.md index 301b5bb95e..0d9e6f1fe8 100644 --- a/docs/blog/posts/h200-mi300x-deepskeek-benchmark.md +++ b/docs/blog/posts/h200-mi300x-deepskeek-benchmark.md @@ -6,8 +6,6 @@ slug: h200-mi300x-deepskeek-benchmark image: https://dstack.ai/static-assets/static-assets/images/h200-mi300x-deepskeek-benchmark-v2.png categories: - Benchmarks - - AMD - - NVIDIA --- # DeepSeek R1 inference performance: MI300X vs. H200 diff --git a/docs/blog/posts/inactivity-duration.md b/docs/blog/posts/inactivity-duration.md index be767f1932..28ea3f5d70 100644 --- a/docs/blog/posts/inactivity-duration.md +++ b/docs/blog/posts/inactivity-duration.md @@ -5,7 +5,7 @@ description: "dstack introduces a new feature that automatically detects and shu slug: inactivity-duration image: https://dstack.ai/static-assets/static-assets/images/inactive-dev-environments-auto-shutdown.png categories: - - Dev environments + - Releases --- # Auto-shutdown for inactive dev environments—no idle GPUs diff --git a/docs/blog/posts/instance-volumes.md b/docs/blog/posts/instance-volumes.md index 702527a53e..c4f5e3b1b1 100644 --- a/docs/blog/posts/instance-volumes.md +++ b/docs/blog/posts/instance-volumes.md @@ -5,7 +5,7 @@ description: "To simplify caching across runs and the use of NFS, we introduce a image: https://dstack.ai/static-assets/static-assets/images/dstack-instance-volumes.png slug: instance-volumes categories: - - Volumes + - Releases --- # Introducing instance volumes to persist data on instances diff --git a/docs/blog/posts/intel-gaudi.md b/docs/blog/posts/intel-gaudi.md index 4ec099342f..7abc69f418 100644 --- a/docs/blog/posts/intel-gaudi.md +++ b/docs/blog/posts/intel-gaudi.md @@ -5,8 +5,7 @@ description: "dstack now supports Intel Gaudi accelerators with SSH fleets, simp slug: intel-gaudi image: https://dstack.ai/static-assets/static-assets/images/dstack-intel-gaudi-and-intel-tiber-cloud.png-v2 categories: - - Intel Gaudi - - SSH fleets + - Releases --- # Supporting Intel Gaudi AI accelerators with SSH fleets diff --git a/docs/blog/posts/metrics-ui.md b/docs/blog/posts/metrics-ui.md index 032115e5a6..74719af2de 100644 --- a/docs/blog/posts/metrics-ui.md +++ b/docs/blog/posts/metrics-ui.md @@ -5,9 +5,7 @@ description: "TBA" slug: metrics-ui image: https://dstack.ai/static-assets/static-assets/images/dstack-metrics-ui-v3-min.png categories: - - Metrics - - AMD - - NVIDIA + - Releases --- # Built-in UI for monitoring essential GPU metrics diff --git a/docs/blog/posts/mpi.md b/docs/blog/posts/mpi.md index 32f6defb65..ef5d685829 100644 --- a/docs/blog/posts/mpi.md +++ b/docs/blog/posts/mpi.md @@ -5,8 +5,7 @@ description: "TBA" slug: mpi image: https://dstack.ai/static-assets/static-assets/images/dstack-mpi-v2.png categories: - - SSH fleets - - Cloud fleets + - Releases --- # Supporting MPI and NCCL/RCCL tests diff --git a/docs/blog/posts/nebius.md b/docs/blog/posts/nebius.md index 02c14ce593..c6f4374db7 100644 --- a/docs/blog/posts/nebius.md +++ b/docs/blog/posts/nebius.md @@ -5,8 +5,7 @@ description: "TBA" slug: nebius image: https://dstack.ai/static-assets/static-assets/images/dstack-nebius-v2.png categories: - - Cloud fleets - - NVIDIA + - Releases --- # Supporting GPU provisioning and orchestration on Nebius diff --git a/docs/blog/posts/nvidia-and-amd-on-vultr.md b/docs/blog/posts/nvidia-and-amd-on-vultr.md index b6354dd03e..eda4519b40 100644 --- a/docs/blog/posts/nvidia-and-amd-on-vultr.md +++ b/docs/blog/posts/nvidia-and-amd-on-vultr.md @@ -5,9 +5,7 @@ description: "Introducing integration with Vultr: The new integration allows Vul slug: nvidia-and-amd-on-vultr image: https://dstack.ai/static-assets/static-assets/images/dstack-vultr.png categories: - - Cloud fleets - - NVIDIA - - AMD + - Releases --- # Supporting NVIDIA and AMD accelerators on Vultr diff --git a/docs/blog/posts/prometheus.md b/docs/blog/posts/prometheus.md index fbaee63c1e..58299dfb4d 100644 --- a/docs/blog/posts/prometheus.md +++ b/docs/blog/posts/prometheus.md @@ -5,8 +5,7 @@ description: "TBA" slug: prometheus image: https://dstack.ai/static-assets/static-assets/images/dstack-prometheus-v3.png categories: - - Metrics - - NVIDIA + - Releases --- # Exporting GPU, cost, and other metrics to Prometheus diff --git a/docs/blog/posts/tpu-on-gcp.md b/docs/blog/posts/tpu-on-gcp.md index 8fbee80dca..c38bea20a2 100644 --- a/docs/blog/posts/tpu-on-gcp.md +++ b/docs/blog/posts/tpu-on-gcp.md @@ -4,7 +4,7 @@ date: 2024-09-10 description: "Learn how to use TPUs with dstack for fine-tuning and deploying LLMs, leveraging open-source tools like Hugging Face’s Optimum TPU and vLLM." slug: tpu-on-gcp categories: - - TPU + - Releases --- # Using TPUs for fine-tuning and deploying LLMs diff --git a/docs/blog/posts/volumes-on-runpod.md b/docs/blog/posts/volumes-on-runpod.md index 9f87c13de0..a6d436790e 100644 --- a/docs/blog/posts/volumes-on-runpod.md +++ b/docs/blog/posts/volumes-on-runpod.md @@ -4,7 +4,7 @@ date: 2024-08-13 description: "Learn how to use volumes with dstack to optimize model inference cold start times on RunPod." slug: volumes-on-runpod categories: - - Volumes + - Releases --- # Using volumes to optimize cold starts on RunPod diff --git a/mkdocs.yml b/mkdocs.yml index c8df9a4ebe..143f3364b5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -64,6 +64,10 @@ plugins: blog_dir: blog post_url_format: "{slug}" blog_toc: true + categories_url_format: "{slug}" + archive: false + categories_name: Blog + categories_sort_reverse: true - social: cards_layout_options: background_color: "black" @@ -288,12 +292,10 @@ nav: - TPU: examples/accelerators/tpu/index.md - Intel Gaudi: examples/accelerators/intel/index.md - Tenstorrent: examples/accelerators/tenstorrent/index.md -# - Misc: -# - Docker Compose: examples/misc/docker-compose/index.md -# - Community: community.md -# - Partners: partners.md - - Blog: - - blog/index.md + - Benchmarks: blog/benchmarks/ + - Case studies: blog/case-studies/ + - Blog: + - blog/index.md # - Discord: https://discord.gg/u8SmfwPpMd" target="_blank # - Changelog: https://github.com/dstackai/dstack/releases" target="_blank # - GitHub: https://github.com/dstackai/dstack" target="_blank From 8bb4803ff2b1d1aaf69cbac1f16455b6f6c45f8f Mon Sep 17 00:00:00 2001 From: peterschmidt85 Date: Thu, 3 Jul 2025 13:32:44 +0200 Subject: [PATCH 2/2] [Docs] Refactoring - [x] Fixed links --- mkdocs.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/mkdocs.yml b/mkdocs.yml index 143f3364b5..e6fac58ed0 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -292,8 +292,8 @@ nav: - TPU: examples/accelerators/tpu/index.md - Intel Gaudi: examples/accelerators/intel/index.md - Tenstorrent: examples/accelerators/tenstorrent/index.md - - Benchmarks: blog/benchmarks/ - - Case studies: blog/case-studies/ + - Benchmarks: blog/benchmarks.md + - Case studies: blog/case-studies.md - Blog: - blog/index.md # - Discord: https://discord.gg/u8SmfwPpMd" target="_blank