From 7379c65e3ec83a88bee60dc48a68b8e4f04508e4 Mon Sep 17 00:00:00 2001
From: Marc Philipp <mail@marcphilipp.de>
Date: Tue, 25 Feb 2025 19:32:40 +0100
Subject: [PATCH] Add more references to Parameterized Containers

---
 documentation/src/docs/asciidoc/user-guide/appendix.adoc  | 2 +-
 .../src/docs/asciidoc/user-guide/extensions.adoc          | 7 +++++--
 .../src/docs/asciidoc/user-guide/writing-tests.adoc       | 8 ++++++--
 3 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/documentation/src/docs/asciidoc/user-guide/appendix.adoc b/documentation/src/docs/asciidoc/user-guide/appendix.adoc
index ab63a5a90b3b..9df8622629d5 100644
--- a/documentation/src/docs/asciidoc/user-guide/appendix.adoc
+++ b/documentation/src/docs/asciidoc/user-guide/appendix.adoc
@@ -105,7 +105,7 @@ Please refer to the corresponding sections for <<running-tests-build-maven-bom,
   `junit-jupiter-engine`::
     JUnit Jupiter test engine implementation; only required at runtime.
   `junit-jupiter-params`::
-    Support for <<writing-tests-parameterized-tests,parameterized tests>> in JUnit Jupiter.
+    Support for <<writing-tests-parameterized-tests>> in JUnit Jupiter.
   `junit-jupiter-migrationsupport`::
     Support for migrating from JUnit 4 to JUnit Jupiter; only required for support for
     JUnit 4's `@Ignore` annotation and for running selected JUnit 4 rules.
diff --git a/documentation/src/docs/asciidoc/user-guide/extensions.adoc b/documentation/src/docs/asciidoc/user-guide/extensions.adoc
index 47bbd8947661..d59fdeedfb7a 100644
--- a/documentation/src/docs/asciidoc/user-guide/extensions.adoc
+++ b/documentation/src/docs/asciidoc/user-guide/extensions.adoc
@@ -804,6 +804,9 @@ implementing different kinds of tests that rely on repetitive invocation of _all
 methods in a test class albeit in different contexts — for example, with different
 parameters, by preparing the test class instance differently, or multiple times without
 modifying the context.
+Please refer to the implementations of
+<<writing-tests-parameterized-tests, Parameterized Containers>> which uses this extension
+point to provide its functionality.
 
 [[extensions-test-templates]]
 === Providing Invocation Contexts for Test Templates
@@ -839,8 +842,8 @@ implementing different kinds of tests that rely on repetitive invocation of a te
 method albeit in different contexts — for example, with different parameters, by preparing
 the test class instance differently, or multiple times without modifying the context.
 Please refer to the implementations of <<writing-tests-repeated-tests>> or
-<<writing-tests-parameterized-tests>> which use this extension point to provide their
-functionality.
+<<writing-tests-parameterized-tests, Parameterized Tests>> which use this extension point
+to provide their functionality.
 
 [[extensions-keeping-state]]
 === Keeping State in Extensions
diff --git a/documentation/src/docs/asciidoc/user-guide/writing-tests.adoc b/documentation/src/docs/asciidoc/user-guide/writing-tests.adoc
index 41697e6dbaeb..dfd048beb2a0 100644
--- a/documentation/src/docs/asciidoc/user-guide/writing-tests.adoc
+++ b/documentation/src/docs/asciidoc/user-guide/writing-tests.adoc
@@ -2634,6 +2634,9 @@ Each invocation of a container template class behaves like the execution of a re
 class with full support for the same lifecycle callbacks and extensions. Please refer to
 <<extensions-container-templates>> for usage examples.
 
+NOTE: <<writing-tests-parameterized-tests, Parameterized Containers>> are built-in
+specializations of container templates.
+
 [[writing-tests-test-templates]]
 === Test Templates
 
@@ -2645,8 +2648,9 @@ invocation of a test template method behaves like the execution of a regular `@T
 method with full support for the same lifecycle callbacks and extensions. Please refer to
 <<extensions-test-templates>> for usage examples.
 
-NOTE: <<writing-tests-repeated-tests>> and <<writing-tests-parameterized-tests>> are
-built-in specializations of test templates.
+NOTE: <<writing-tests-repeated-tests>> and
+<<writing-tests-parameterized-tests, Parameterized Tests>> are built-in specializations of
+test templates.
 
 [[writing-tests-dynamic-tests]]
 === Dynamic Tests