diff --git a/.github/workflows/validate-upstream.yml b/.github/workflows/validate-upstream.yml
index d7e5d40b9817..a7ce12c3ba71 100644
--- a/.github/workflows/validate-upstream.yml
+++ b/.github/workflows/validate-upstream.yml
@@ -2,6 +2,9 @@
 # - module-name: the name of the module, without github.com prefix (e.g., docker/buildx)
 # - data-files-id: id of the artifact (using actions/upload-artifact) containing the YAML data files to validate (optional)
 # - data-files-folder: folder in _data containing the files to download and copy to (e.g., buildx)
+# if changes are made in this workflow, please keep commit sha updated on downstream workflows:
+# - https://github.com/docker/buildx/blob/master/.github/workflows/docs-upstream.yml
+# - https://github.com/docker/compose/blob/main/.github/workflows/docs-upstream.yml
 name: validate-upstream
 
 on: