diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index d244b4563..787e73159 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -6,12 +6,9 @@
 # Our pipeline consists of static and dynamic parts.
 # 
 # This file only contains the static parts of our pipeline.
-# Dynamic jobs are defined in .gitlab-ci/dynamic-ci.yml.
-# These are used as a template to generate jobs during the pipeline runtime.
-# 
-# The marker "#dyn#" (without quotes) will be replaced by concrete values.
-# 
-# TODO: documentation about dynamic stage
+# Dynamic jobs are defined in .gitlab-ci/frontend.yml and .gitlab-ci/backend.yml.
+# These are used as a template to generate downstream (child) pipelines during 
+# the runtime of the upstream (parent) pipeline.
 ###
 
 
@@ -103,6 +100,7 @@ setup:containers:frontend:
   rules:
     - when: always
 
+# TODO: switch to exec logic as above (see frontend container)
 setup:containers:backend: &containers-backend
   stage: setup
   needs:
diff --git a/.gitlab-ci/backend.yml b/.gitlab-ci/backend.yml
index 834886c3f..a37752bf0 100644
--- a/.gitlab-ci/backend.yml
+++ b/.gitlab-ci/backend.yml
@@ -5,7 +5,7 @@
 ### IMPORTANT NOTICE ###
 # Our pipeline consists of static and dynamic parts.
 # 
-# This file only contains the dynamic parts of our pipeline.
+# This file only contains the dynamic backend parts of our pipeline.
 # Static jobs are defined in .gitlab-ci.yml.
 # 
 # The marker "#dyn#" (without quotes) will be replaced by concrete values.
diff --git a/.gitlab-ci/frontend.yml b/.gitlab-ci/frontend.yml
index 7eec4cf4c..b212a211c 100644
--- a/.gitlab-ci/frontend.yml
+++ b/.gitlab-ci/frontend.yml
@@ -5,7 +5,7 @@
 ### IMPORTANT NOTICE ###
 # Our pipeline consists of static and dynamic parts.
 # 
-# This file only contains the dynamic parts of our pipeline.
+# This file only contains the dynamic frontend parts of our pipeline.
 # Static jobs are defined in .gitlab-ci.yml.
 # 
 # The marker "#dyn#" (without quotes) will be replaced by concrete values.