From aed069454738f638cf9fa8b39010549aba05262f Mon Sep 17 00:00:00 2001
From: Herrtian <70463940+Herrtian@users.noreply.github.com>
Date: Fri, 8 May 2026 10:24:03 +0200
Subject: [PATCH] Document separate build and publish jobs

---
 ...bution-releases-using-github-actions-ci-cd-workflows.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst b/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst
index 3b5e6ed28..035a8af8a 100644
--- a/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst
+++ b/source/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows.rst
@@ -104,6 +104,12 @@ We will have to define two jobs to publish to PyPI
 and TestPyPI respectively, and an additional job to
 build the distribution packages.
 
+.. important::
+
+   Keep the build job separate from the publishing jobs. Building
+   distributions in a publishing job is unsupported; publishing jobs should
+   only download the already-built artifacts and upload them.
+
 First, we'll define the job for building the dist packages of
 your project and storing them for later use: