diff --git a/templates/python_projects.gitlab-ci.yml b/templates/python_projects.gitlab-ci.yml
index dff0b46096e894663732ec0a2643505cf79761c2..80a0d7fba9543d74f2a1d35f609c2ed09048c2d4 100644
--- a/templates/python_projects.gitlab-ci.yml
+++ b/templates/python_projects.gitlab-ci.yml
@@ -3,10 +3,9 @@ include:
 
 
 variables:
-  # required to set:
-  PACKAGES_TO_CHECK: ""
-  # may be set:
-  PYPROJECT_CONFIG_PATH: ""
+  PACKAGES_TO_CHECK: ""  # required to set when using linter-specific job templates
+  PYPROJECT_CONFIG_PATH: ""  # may be set when using linter-specific job templates
+  # registries:
   # uses registry.gitlab.syncad.com/hive/hive/ci-base-image:ubuntu22.04-10
   PYTHON_IMAGE_TAG: "@sha256:080b16fd53013aeb9b89b00a8dfc90fecf886173f46448b05f45cee376c43330"
   PYTHON_IMAGE: "registry.gitlab.syncad.com/hive/hive/ci-base-image${PYTHON_IMAGE_TAG}"