From 67a96d7ba3208a727f30087e54b93fcaf062fdc2 Mon Sep 17 00:00:00 2001
From: "vitko-bench-agent[bot]"
 <337942827+vitko-bench-agent[bot]@users.noreply.github.com>
Date: Sat, 17 Oct 2026 01:52:41 +0000
Subject: [PATCH] README: the one-step workflow and the docs link up front

---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 64b9d1e..9672054 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,20 @@ else.
 On any other runner (GitHub-hosted, your own machines) the step simply runs all your tests, as a
 plain `run:` step would, so the same workflow works everywhere.
 
+```yaml
+jobs:
+  test:
+    runs-on: vitko-ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v5
+      - run: uv sync --locked
+      - uses: vitko-inc/split-tests@v1   # one step: the suite runs as parallel parts
+        with:
+          run: uv run --locked pytest -q
+```
+
+Full documentation: [Test parallelization on Vitko Runners](https://runners.vitko.inc/docs/split-tests/).
+
 ## Add it to your workflow
 
 Replace your test step with the `vitko-inc/split-tests` action, and put your test command in