From dc06214ff8f38cb2e2cb5ade9f5660d977f178a9 Mon Sep 17 00:00:00 2001
From: Kabir Khan <kkhan@redhat.com>
Date: Fri, 5 Jan 2024 14:25:56 +0000
Subject: [PATCH] Add comments clarifying filename vs name

---
 batch-processing/pom.xml                      |  9 ++++-
 bmt/pom.xml                                   |  8 +++++
 cmt/pom.xml                                   |  8 +++++
 ee-security/pom.xml                           |  9 ++++-
 ejb-remote/pom.xml                            |  9 ++++-
 ejb-security-context-propagation/pom.xml      |  5 ++-
 ejb-security-programmatic-auth/pom.xml        |  5 ++-
 ejb-timer/pom.xml                             | 11 ++++--
 helloworld-jms/pom.xml                        |  8 +++++
 helloworld-mdb/pom.xml                        |  8 +++++
 helloworld-ws/pom.xml                         |  8 +++++
 helloworld/pom.xml                            |  9 ++++-
 hibernate/pom.xml                             |  8 +++++
 http-custom-mechanism/webapp/pom.xml          |  5 ++-
 jaxrs-client/pom.xml                          | 10 ++++--
 jaxrs-jwt/pom.xml                             | 10 ++++--
 jaxws-ejb/pom.xml                             |  8 +++++
 jaxws-retail/pom.xml                          |  8 +++++
 jsonp/pom.xml                                 |  9 ++++-
 kitchensink/pom.xml                           |  8 +++++
 logging/pom.xml                               | 10 ++++--
 mail/pom.xml                                  |  5 ++-
 microprofile-config/pom.xml                   | 10 +++++-
 microprofile-fault-tolerance/pom.xml          | 16 ++++++---
 microprofile-health/pom.xml                   | 10 +++++-
 microprofile-jwt/pom.xml                      | 10 +++++-
 microprofile-lra/pom.xml                      | 16 ++++++---
 microprofile-openapi/pom.xml                  | 28 +++++++++------
 microprofile-reactive-messaging-kafka/pom.xml | 34 ++++++++++++-------
 microprofile-rest-client/pom.xml              | 18 +++++++---
 numberguess/pom.xml                           |  8 +++++
 remote-helloworld-mdb/pom.xml                 |  8 +++++
 servlet-async/pom.xml                         |  8 +++++
 servlet-filterlistener/pom.xml                |  8 +++++
 servlet-security/pom.xml                      |  8 +++++
 spring-resteasy/pom.xml                       |  9 ++++-
 temperature-converter/pom.xml                 |  8 +++++
 thread-racing/pom.xml                         |  8 +++++
 todo-backend/pom.xml                          |  9 ++++-
 websocket-endpoint/pom.xml                    |  8 +++++
 websocket-hello/pom.xml                       |  8 +++++
 41 files changed, 352 insertions(+), 58 deletions(-)

diff --git a/batch-processing/pom.xml b/batch-processing/pom.xml
index 2beeb05f1b..b4a20c1381 100644
--- a/batch-processing/pom.xml
+++ b/batch-processing/pom.xml
@@ -260,7 +260,10 @@
                                     <addOn>h2-database:default</addOn>
                                 </addOns>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -289,6 +292,10 @@
                                     <addOn>h2-database:default</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/bmt/pom.xml b/bmt/pom.xml
index ee43d5c99b..d217b8af60 100644
--- a/bmt/pom.xml
+++ b/bmt/pom.xml
@@ -201,6 +201,10 @@
                                     <addOn>h2-database:default</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -230,6 +234,10 @@
                                     <addOn>h2-database:default</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/cmt/pom.xml b/cmt/pom.xml
index d695145e60..cd58ba33c3 100644
--- a/cmt/pom.xml
+++ b/cmt/pom.xml
@@ -205,6 +205,10 @@
                                     <addOn>h2-database:default</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -234,6 +238,10 @@
                                     <addOn>h2-database:default</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/ee-security/pom.xml b/ee-security/pom.xml
index 4c1f7a05f6..446fbc40af 100644
--- a/ee-security/pom.xml
+++ b/ee-security/pom.xml
@@ -181,7 +181,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <packaging-scripts>
                                 <packaging-script>
@@ -216,6 +219,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                             <packaging-scripts>
                                 <packaging-script>
diff --git a/ejb-remote/pom.xml b/ejb-remote/pom.xml
index 9c6fc42efc..955dc66188 100644
--- a/ejb-remote/pom.xml
+++ b/ejb-remote/pom.xml
@@ -173,7 +173,10 @@
                                     <addOn>wildfly-cli</addOn>
                                 </addOns>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -202,6 +205,10 @@
                                 </addOns>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/ejb-security-context-propagation/pom.xml b/ejb-security-context-propagation/pom.xml
index 8a3d63fcdd..0cf7d3bede 100644
--- a/ejb-security-context-propagation/pom.xml
+++ b/ejb-security-context-propagation/pom.xml
@@ -211,7 +211,10 @@
                                     <resolve-expressions>false</resolve-expressions>
                                 </packaging-script>
                             </packaging-scripts>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
diff --git a/ejb-security-programmatic-auth/pom.xml b/ejb-security-programmatic-auth/pom.xml
index 2b12b647c9..59a0d12cc4 100644
--- a/ejb-security-programmatic-auth/pom.xml
+++ b/ejb-security-programmatic-auth/pom.xml
@@ -234,7 +234,10 @@
                                     <resolve-expressions>false</resolve-expressions>
                                 </packaging-script>
                             </packaging-scripts>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
diff --git a/ejb-timer/pom.xml b/ejb-timer/pom.xml
index bcea7b6f9a..8ff6ee4c19 100644
--- a/ejb-timer/pom.xml
+++ b/ejb-timer/pom.xml
@@ -182,7 +182,10 @@
                             <discover-provisioning-info>
                               <version>${version.server}</version>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -207,7 +210,11 @@
                             <discover-provisioning-info>
                               <version>${version.server}</version>
                               <context>cloud</context>
-                          </discover-provisioning-info>
+                            </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/helloworld-jms/pom.xml b/helloworld-jms/pom.xml
index 6244f40ca3..d476d3aa87 100644
--- a/helloworld-jms/pom.xml
+++ b/helloworld-jms/pom.xml
@@ -172,6 +172,10 @@
                                     <add-on>wildfly-cli</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <packaging-scripts>
                                 <packaging-script>
@@ -209,6 +213,10 @@
                                     <add-on>embedded-activemq</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                             <packaging-scripts>
                                 <packaging-script>
diff --git a/helloworld-mdb/pom.xml b/helloworld-mdb/pom.xml
index cba60fb4be..f8f4602a86 100644
--- a/helloworld-mdb/pom.xml
+++ b/helloworld-mdb/pom.xml
@@ -188,6 +188,10 @@
                                     <addOn>embedded-activemq</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -216,6 +220,10 @@
                                     <addOn>embedded-activemq</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/helloworld-ws/pom.xml b/helloworld-ws/pom.xml
index 3228125d75..328f7f136d 100644
--- a/helloworld-ws/pom.xml
+++ b/helloworld-ws/pom.xml
@@ -188,6 +188,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -214,6 +218,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/helloworld/pom.xml b/helloworld/pom.xml
index 905cebd6ea..cbd61f0458 100644
--- a/helloworld/pom.xml
+++ b/helloworld/pom.xml
@@ -158,7 +158,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -184,6 +187,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/hibernate/pom.xml b/hibernate/pom.xml
index baa1bd89d1..d21d596caf 100644
--- a/hibernate/pom.xml
+++ b/hibernate/pom.xml
@@ -227,6 +227,10 @@
                                     <add-on>h2-database</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <packaging-scripts>
                                 <packaging-script>
@@ -266,6 +270,10 @@
                                     <add-on>h2-database</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                             <packaging-scripts>
                                 <packaging-script>
diff --git a/http-custom-mechanism/webapp/pom.xml b/http-custom-mechanism/webapp/pom.xml
index bea39ae249..b6025587a4 100644
--- a/http-custom-mechanism/webapp/pom.xml
+++ b/http-custom-mechanism/webapp/pom.xml
@@ -77,7 +77,10 @@
                                     <addOn>wildfly-cli</addOn>
                                 </addOns>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <packaging-scripts>
                                 <packaging-script>
diff --git a/jaxrs-client/pom.xml b/jaxrs-client/pom.xml
index cc8288ed9f..8f3ad7b9f3 100644
--- a/jaxrs-client/pom.xml
+++ b/jaxrs-client/pom.xml
@@ -161,7 +161,10 @@
                         <groupId>org.wildfly.plugins</groupId>
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <configuration>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
@@ -186,7 +189,10 @@
                         <groupId>org.wildfly.plugins</groupId>
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <configuration>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
diff --git a/jaxrs-jwt/pom.xml b/jaxrs-jwt/pom.xml
index f8ed4804f5..26a0a5915b 100644
--- a/jaxrs-jwt/pom.xml
+++ b/jaxrs-jwt/pom.xml
@@ -161,7 +161,10 @@
                         <groupId>org.wildfly.plugins</groupId>
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <configuration>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
@@ -196,7 +199,10 @@
                         <groupId>org.wildfly.plugins</groupId>
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <configuration>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
diff --git a/jaxws-ejb/pom.xml b/jaxws-ejb/pom.xml
index 1f281646cf..493c138331 100644
--- a/jaxws-ejb/pom.xml
+++ b/jaxws-ejb/pom.xml
@@ -198,6 +198,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -224,6 +228,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/jaxws-retail/pom.xml b/jaxws-retail/pom.xml
index 25b08ae6aa..d7f3544dc9 100644
--- a/jaxws-retail/pom.xml
+++ b/jaxws-retail/pom.xml
@@ -225,6 +225,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -251,6 +255,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/jsonp/pom.xml b/jsonp/pom.xml
index 7601ef757e..013e626419 100644
--- a/jsonp/pom.xml
+++ b/jsonp/pom.xml
@@ -210,7 +210,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -236,6 +239,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/kitchensink/pom.xml b/kitchensink/pom.xml
index 048fa93a45..8a1aaf8749 100644
--- a/kitchensink/pom.xml
+++ b/kitchensink/pom.xml
@@ -291,6 +291,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -316,6 +320,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/logging/pom.xml b/logging/pom.xml
index 64d79a5d7e..38dfcd7786 100644
--- a/logging/pom.xml
+++ b/logging/pom.xml
@@ -163,7 +163,10 @@
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <version>${version.plugin.wildfly}</version>
                         <configuration>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
@@ -201,7 +204,10 @@
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <version>${version.plugin.wildfly}</version>
                         <configuration>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
diff --git a/mail/pom.xml b/mail/pom.xml
index 07222addf3..cbe181bf38 100644
--- a/mail/pom.xml
+++ b/mail/pom.xml
@@ -202,7 +202,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <packaging-scripts>
                                 <packaging-script>
diff --git a/microprofile-config/pom.xml b/microprofile-config/pom.xml
index c3e0c382ed..ad2339a91b 100644
--- a/microprofile-config/pom.xml
+++ b/microprofile-config/pom.xml
@@ -198,7 +198,11 @@
                               <version>${version.server}</version>
                           </discover-provisioning-info>
                           <bootable-jar>true</bootable-jar>
-                          <runtime-name>ROOT.war</runtime-name>
+                          <!--
+                            Rename the output war to ROOT.war before adding it to the server, so that the
+                            application is deployed in the root web context.
+                          -->
+                          <name>ROOT.war</name>
                       </configuration>
                       <executions>
                           <execution>
@@ -223,6 +227,10 @@
                               <version>${version.server}</version>
                               <context>cloud</context>
                           </discover-provisioning-info>
+                          <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                           <filename>ROOT.war</filename>
                       </configuration>
                       <executions>
diff --git a/microprofile-fault-tolerance/pom.xml b/microprofile-fault-tolerance/pom.xml
index b952e566cd..2dfbe1104b 100644
--- a/microprofile-fault-tolerance/pom.xml
+++ b/microprofile-fault-tolerance/pom.xml
@@ -237,7 +237,11 @@
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
                             <bootable-jar>true</bootable-jar>
-                            <runtime-name>ROOT.war</runtime-name>
+                            <!--
+                              Rename the output war to ROOT.war before adding it to the server, so that the
+                              application is deployed in the root web context.
+                            -->
+                            <name>ROOT.war</name>
                         </configuration>
                         <executions>
                             <execution>
@@ -258,11 +262,15 @@
                         <groupId>org.wildfly.plugins</groupId>
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <configuration>
-                          <discover-provisioning-info>
+                            <discover-provisioning-info>
                               <version>${version.server}</version>
                               <context>cloud</context>
-                          </discover-provisioning-info>
-                          <filename>ROOT.war</filename>
+                            </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
+                            <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
                             <execution>
diff --git a/microprofile-health/pom.xml b/microprofile-health/pom.xml
index 5e96f7fc35..f8475897a7 100644
--- a/microprofile-health/pom.xml
+++ b/microprofile-health/pom.xml
@@ -185,7 +185,11 @@
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
                             <bootable-jar>true</bootable-jar>
-                            <runtime-name>ROOT.war</runtime-name>
+                            <!--
+                              Rename the output war to ROOT.war before adding it to the server, so that the
+                              application is deployed in the root web context.
+                            -->
+                            <name>ROOT.war</name>
                         </configuration>
                         <executions>
                             <execution>
@@ -210,6 +214,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/microprofile-jwt/pom.xml b/microprofile-jwt/pom.xml
index 1288a12f34..2ef5367df1 100644
--- a/microprofile-jwt/pom.xml
+++ b/microprofile-jwt/pom.xml
@@ -247,7 +247,11 @@
                               <version>${version.server}</version>
                           </discover-provisioning-info>
                           <bootable-jar>true</bootable-jar>
-                          <runtime-name>ROOT.war</runtime-name>
+                          <!--
+                            Rename the output war to ROOT.war before adding it to the server, so that the
+                            application is deployed in the root web context.
+                          -->
+                          <name>ROOT.war</name>
                       </configuration>
                       <executions>
                           <execution>
@@ -273,6 +277,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/microprofile-lra/pom.xml b/microprofile-lra/pom.xml
index 2179fbdd53..511c3c7431 100644
--- a/microprofile-lra/pom.xml
+++ b/microprofile-lra/pom.xml
@@ -163,14 +163,18 @@
                         <groupId>org.wildfly.plugins</groupId>
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <configuration>
-                          <discover-provisioning-info>
+                            <discover-provisioning-info>
                               <version>${version.server}</version>
                               <add-ons>
                                 <add-on>lra-coordinator</add-on>
                               </add-ons>
-                          </discover-provisioning-info>
-                          <bootable-jar>true</bootable-jar>
-                          <runtime-name>ROOT.war</runtime-name>
+                            </discover-provisioning-info>
+                            <bootable-jar>true</bootable-jar>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
+                            <name>ROOT.war</name>
                         </configuration>
                         <executions>
                             <execution>
@@ -198,6 +202,10 @@
                                     <add-on>lra-coordinator</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/microprofile-openapi/pom.xml b/microprofile-openapi/pom.xml
index dd38c7022c..bc895e7a58 100644
--- a/microprofile-openapi/pom.xml
+++ b/microprofile-openapi/pom.xml
@@ -142,25 +142,29 @@
             <build>
                 <plugins>
                     <plugin>
-                      <groupId>org.wildfly.plugins</groupId>
-                      <artifactId>wildfly-maven-plugin</artifactId>
-                      <configuration>
-                          <discover-provisioning-info>
+                        <groupId>org.wildfly.plugins</groupId>
+                        <artifactId>wildfly-maven-plugin</artifactId>
+                        <configuration>
+                            <discover-provisioning-info>
                               <version>${version.server}</version>
                               <add-ons>
                                   <add-on>openapi</add-on>
                               </add-ons>
-                          </discover-provisioning-info>
-                          <bootable-jar>true</bootable-jar>
-                          <runtime-name>ROOT.war</runtime-name>
-                      </configuration>
-                      <executions>
+                            </discover-provisioning-info>
+                            <bootable-jar>true</bootable-jar>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
+                            <name>ROOT.war</name>
+                        </configuration>
+                        <executions>
                           <execution>
                               <goals>
                                   <goal>package</goal>
                               </goals>
                           </execution>
-                      </executions>
+                        </executions>
                   </plugin>
                 </plugins>
             </build>
@@ -180,6 +184,10 @@
                                     <add-on>openapi</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/microprofile-reactive-messaging-kafka/pom.xml b/microprofile-reactive-messaging-kafka/pom.xml
index 145f1b78ff..f4b35aba53 100644
--- a/microprofile-reactive-messaging-kafka/pom.xml
+++ b/microprofile-reactive-messaging-kafka/pom.xml
@@ -275,22 +275,26 @@
             <build>
                 <plugins>
                     <plugin>
-                      <groupId>org.wildfly.plugins</groupId>
-                      <artifactId>wildfly-maven-plugin</artifactId>
-                      <configuration>
-                          <discover-provisioning-info>
-                              <version>${version.server}</version>
-                          </discover-provisioning-info>
-                          <bootable-jar>true</bootable-jar>
-                          <runtime-name>ROOT.war</runtime-name>
-                      </configuration>
-                      <executions>
-                          <execution>
+                        <groupId>org.wildfly.plugins</groupId>
+                        <artifactId>wildfly-maven-plugin</artifactId>
+                        <configuration>
+                            <discover-provisioning-info>
+                                <version>${version.server}</version>
+                            </discover-provisioning-info>
+                            <bootable-jar>true</bootable-jar>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
+                            <name>ROOT.war</name>
+                        </configuration>
+                        <executions>
+                            <execution>
                               <goals>
                                   <goal>package</goal>
                               </goals>
-                          </execution>
-                      </executions>
+                            </execution>
+                        </executions>
                   </plugin>
                 </plugins>
             </build>
@@ -308,6 +312,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/microprofile-rest-client/pom.xml b/microprofile-rest-client/pom.xml
index 363153e75f..7306655a4d 100644
--- a/microprofile-rest-client/pom.xml
+++ b/microprofile-rest-client/pom.xml
@@ -207,12 +207,16 @@
                         <groupId>org.wildfly.plugins</groupId>
                         <artifactId>wildfly-maven-plugin</artifactId>
                         <configuration>
-                          <discover-provisioning-info>
+                            <discover-provisioning-info>
                               <version>${version.server}</version>
-                          </discover-provisioning-info>
-                          <bootable-jar>true</bootable-jar>
-                          <runtime-name>ROOT.war</runtime-name>
-                      </configuration>
+                            </discover-provisioning-info>
+                            <bootable-jar>true</bootable-jar>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
+                            <name>ROOT.war</name>
+                        </configuration>
                         <executions>
                             <execution>
                                 <goals>
@@ -237,6 +241,10 @@
                               <version>${version.server}</version>
                               <context>cloud</context>
                           </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                           <filename>ROOT.war</filename>
                       </configuration>
                         <executions>
diff --git a/numberguess/pom.xml b/numberguess/pom.xml
index 5143deca4c..41039117a3 100644
--- a/numberguess/pom.xml
+++ b/numberguess/pom.xml
@@ -174,6 +174,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -199,6 +203,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/remote-helloworld-mdb/pom.xml b/remote-helloworld-mdb/pom.xml
index 7b20d30a0d..86f3a3cf7c 100644
--- a/remote-helloworld-mdb/pom.xml
+++ b/remote-helloworld-mdb/pom.xml
@@ -189,6 +189,10 @@
                                     <addOn>remote-activemq</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -217,6 +221,10 @@
                                     <addOn>remote-activemq</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/servlet-async/pom.xml b/servlet-async/pom.xml
index a3bef44872..0e72b8ae61 100644
--- a/servlet-async/pom.xml
+++ b/servlet-async/pom.xml
@@ -185,6 +185,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -210,6 +214,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/servlet-filterlistener/pom.xml b/servlet-filterlistener/pom.xml
index 70184dadb8..c6dd733140 100644
--- a/servlet-filterlistener/pom.xml
+++ b/servlet-filterlistener/pom.xml
@@ -185,6 +185,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -210,6 +214,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/servlet-security/pom.xml b/servlet-security/pom.xml
index 56136b65ec..5ed6e05fa7 100644
--- a/servlet-security/pom.xml
+++ b/servlet-security/pom.xml
@@ -189,6 +189,10 @@
                                     <add-on>h2-database</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <runtimeName>ROOT.war</runtimeName>
                             <packaging-scripts>
                                 <packaging-script>
@@ -228,6 +232,10 @@
                                 </add-ons>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                             <packaging-scripts>
                                 <packaging-script>
diff --git a/spring-resteasy/pom.xml b/spring-resteasy/pom.xml
index 4dad2b744e..1fcc690468 100644
--- a/spring-resteasy/pom.xml
+++ b/spring-resteasy/pom.xml
@@ -233,7 +233,10 @@
                                 -->
                                 <failsOnError>false</failsOnError>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -264,6 +267,10 @@
                                 -->
                                 <failsOnError>false</failsOnError>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/temperature-converter/pom.xml b/temperature-converter/pom.xml
index e817249adf..e1d6aed32e 100644
--- a/temperature-converter/pom.xml
+++ b/temperature-converter/pom.xml
@@ -191,6 +191,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -216,6 +220,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/thread-racing/pom.xml b/thread-racing/pom.xml
index 2b916e81b6..8175938968 100644
--- a/thread-racing/pom.xml
+++ b/thread-racing/pom.xml
@@ -244,6 +244,10 @@
                                     <addOn>h2-database:default</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -273,6 +277,10 @@
                                     <addOn>h2-database:default</addOn>
                                 </addOns>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/todo-backend/pom.xml b/todo-backend/pom.xml
index cee675b430..13792ddc66 100644
--- a/todo-backend/pom.xml
+++ b/todo-backend/pom.xml
@@ -200,7 +200,10 @@
                                     <add-on>postgresql</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
-                            <!-- deploys the quickstart on root web context -->
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                             <packaging-scripts>
                                 <packaging-script>
@@ -238,6 +241,10 @@
                                     <add-on>postgresql</add-on>
                                 </add-ons>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                             <packaging-scripts>
                                 <packaging-script>
diff --git a/websocket-endpoint/pom.xml b/websocket-endpoint/pom.xml
index 809c81a830..135d9a74a8 100644
--- a/websocket-endpoint/pom.xml
+++ b/websocket-endpoint/pom.xml
@@ -211,6 +211,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -236,6 +240,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>
diff --git a/websocket-hello/pom.xml b/websocket-hello/pom.xml
index 70e572c625..65b9e6d618 100644
--- a/websocket-hello/pom.xml
+++ b/websocket-hello/pom.xml
@@ -162,6 +162,10 @@
                             <discover-provisioning-info>
                                 <version>${version.server}</version>
                             </discover-provisioning-info>
+                            <!--
+                                Rename the output war to ROOT.war before adding it to the server, so that the
+                                application is deployed in the root web context.
+                            -->
                             <name>ROOT.war</name>
                         </configuration>
                         <executions>
@@ -187,6 +191,10 @@
                                 <version>${version.server}</version>
                                 <context>cloud</context>
                             </discover-provisioning-info>
+                            <!--
+                                The parent POM's 'openshift' profile renames the output archive to ROOT.war so that the
+                                application is deployed in the root web context. Add ROOT.war to the server.
+                            -->
                             <filename>ROOT.war</filename>
                         </configuration>
                         <executions>