diff --git a/cookiecutter/{{cookiecutter.github_repo_name}}/pyproject.toml b/cookiecutter/{{cookiecutter.github_repo_name}}/pyproject.toml
index adfb1e1a..d159ca53 100644
--- a/cookiecutter/{{cookiecutter.github_repo_name}}/pyproject.toml
+++ b/cookiecutter/{{cookiecutter.github_repo_name}}/pyproject.toml
@@ -36,9 +36,9 @@ requires-python = ">= 3.11, < 4"
 {%- if cookiecutter.type in ("app", "actor", "model") %}
 dependencies = [
   "typing-extensions == 4.5.0",
-  # Make sure to update the mkdocs.yml file when
-  # changing the version
-  # (plugins.mkdocstrings.handlers.python.import)
+  # Make sure to update the version for cross-referencing also in the
+  # mkdocs.yml file when changing the version here (look for the config key
+  # plugins.mkdocstrings.handlers.python.import)
   "frequenz-sdk == 0.24.0",
 ]
 {%- elif cookiecutter.type == "api" %}
diff --git a/tests_golden/integration/test_cookiecutter_generation/actor/frequenz-actor-test/pyproject.toml b/tests_golden/integration/test_cookiecutter_generation/actor/frequenz-actor-test/pyproject.toml
index 4a1fa1e4..13726a2e 100644
--- a/tests_golden/integration/test_cookiecutter_generation/actor/frequenz-actor-test/pyproject.toml
+++ b/tests_golden/integration/test_cookiecutter_generation/actor/frequenz-actor-test/pyproject.toml
@@ -29,9 +29,9 @@ requires-python = ">= 3.11, < 4"
 # TODO(cookiecutter): Remove and add more dependencies if appropriate
 dependencies = [
   "typing-extensions == 4.5.0",
-  # Make sure to update the mkdocs.yml file when
-  # changing the version
-  # (plugins.mkdocstrings.handlers.python.import)
+  # Make sure to update the version for cross-referencing also in the
+  # mkdocs.yml file when changing the version here (look for the config key
+  # plugins.mkdocstrings.handlers.python.import)
   "frequenz-sdk == 0.24.0",
 ]
 dynamic = ["version"]
diff --git a/tests_golden/integration/test_cookiecutter_generation/app/frequenz-app-test/pyproject.toml b/tests_golden/integration/test_cookiecutter_generation/app/frequenz-app-test/pyproject.toml
index f593da5a..a5c94e30 100644
--- a/tests_golden/integration/test_cookiecutter_generation/app/frequenz-app-test/pyproject.toml
+++ b/tests_golden/integration/test_cookiecutter_generation/app/frequenz-app-test/pyproject.toml
@@ -28,9 +28,9 @@ requires-python = ">= 3.11, < 4"
 # TODO(cookiecutter): Remove and add more dependencies if appropriate
 dependencies = [
   "typing-extensions == 4.5.0",
-  # Make sure to update the mkdocs.yml file when
-  # changing the version
-  # (plugins.mkdocstrings.handlers.python.import)
+  # Make sure to update the version for cross-referencing also in the
+  # mkdocs.yml file when changing the version here (look for the config key
+  # plugins.mkdocstrings.handlers.python.import)
   "frequenz-sdk == 0.24.0",
 ]
 dynamic = ["version"]
diff --git a/tests_golden/integration/test_cookiecutter_generation/model/frequenz-model-test/pyproject.toml b/tests_golden/integration/test_cookiecutter_generation/model/frequenz-model-test/pyproject.toml
index bd1822b4..688fc737 100644
--- a/tests_golden/integration/test_cookiecutter_generation/model/frequenz-model-test/pyproject.toml
+++ b/tests_golden/integration/test_cookiecutter_generation/model/frequenz-model-test/pyproject.toml
@@ -29,9 +29,9 @@ requires-python = ">= 3.11, < 4"
 # TODO(cookiecutter): Remove and add more dependencies if appropriate
 dependencies = [
   "typing-extensions == 4.5.0",
-  # Make sure to update the mkdocs.yml file when
-  # changing the version
-  # (plugins.mkdocstrings.handlers.python.import)
+  # Make sure to update the version for cross-referencing also in the
+  # mkdocs.yml file when changing the version here (look for the config key
+  # plugins.mkdocstrings.handlers.python.import)
   "frequenz-sdk == 0.24.0",
 ]
 dynamic = ["version"]