From 6c4b91b9f6000b242e528096ad6ad1df500afa78 Mon Sep 17 00:00:00 2001 From: Pedro Henrique Penna Date: Sun, 11 Oct 2026 14:08:29 -0300 Subject: [PATCH] doc: state that documentation-only dev pushes publish no packages The distribution guide said that every dev push stages and archives the three platform packages. The platform jobs run only when change classification selects the workload suites, so a documentation-only push skips them and gets no development release; download then falls back to the nearest released first-parent ancestor. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- doc/distribution.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/doc/distribution.md b/doc/distribution.md index 7cdbd87b..da6ed1c7 100644 --- a/doc/distribution.md +++ b/doc/distribution.md @@ -94,10 +94,17 @@ python3 scripts/nvx.py archive-release \ it writes a `.tar.gz` or `.zip` archive outside the staged directory; see [`archive-release`](usage.md#archive-release). -CI follows the binary-only path. On `dev` pushes, the `linux-kvm`, -`linux-mshv`, and `windows-whp` platform jobs each stage -`dist/nvx--` with `--binary-only`, then archive it as -`.tar.gz` on Linux and `.zip` on Windows through the +CI follows the binary-only path. On a `dev` push that changes more than +documentation, the `linux-kvm`, `linux-mshv`, and `windows-whp` platform jobs +each stage `dist/nvx--` with `--binary-only`, then archive +it as `.tar.gz` on Linux and `.zip` on Windows through the [`package-release`](../.github/actions/package-release/action.yml) action. [Continuous integration](ci.md) describes the jobs that gate and publish the resulting development release. + +A documentation-only push, in which every changed path is under `doc/` or ends +in `.md`, skips the platform jobs, as +[Change classification](ci.md#change-classification) describes. Such a commit +gets no packages and no development release, so +[`download`](usage.md#download) installs the package of its nearest released +first-parent ancestor.