From 32d0d53fddb4ab30bf69796300ad8f2fb5297915 Mon Sep 17 00:00:00 2001
From: Jean-Frederic Clere <jfclere@gmail.com>
Date: Mon, 26 Jun 2023 16:16:52 +0200
Subject: [PATCH] Arrange the doc for DNSMembershipProvider. Follow up to
 https://bz.apache.org/bugzilla/show_bug.cgi?id=66660

---
 .../cloud/DNSMembershipProvider.java          | 26 ++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/java/org/apache/catalina/tribes/membership/cloud/DNSMembershipProvider.java b/java/org/apache/catalina/tribes/membership/cloud/DNSMembershipProvider.java
index f5a687449668..a9b89e25736d 100644
--- a/java/org/apache/catalina/tribes/membership/cloud/DNSMembershipProvider.java
+++ b/java/org/apache/catalina/tribes/membership/cloud/DNSMembershipProvider.java
@@ -60,6 +60,8 @@
  *  }
  *  </pre>
  *
+ * minimal example for the Service my-tomcat-app-membership, note the <strong>selector</strong><br>
+ *
  * {@code dns-membership-service.yml }
  *
  * <pre>
@@ -73,14 +75,32 @@
  *   name: my-tomcat-app-membership
  * spec:
  *   clusterIP: None
- *   ports:
- *   - name: membership
- *     port: 8888
  *   selector:
  *     app: my-tomcat-app
  * }
  * </pre>
  *
+ * First Tomcat pod minimal example, note the <strong>labels</strong> that must correspond to the <strong>selector</strong> in the service.<br>
+ *
+ * {@code tomcat1.yml }
+ *
+ * <pre>
+ * {@code
+ * apiVersion: v1
+ * kind: Pod
+ * metadata:
+ *   name: tomcat1
+ *   labels:
+ *     app: my-tomcat-app
+ * spec:
+ *   containers:
+ *   - name: tomcat
+ *     image: tomcat
+ *     ports:
+ *     - containerPort: 8080
+ * }
+ * </pre>
+ *
  * Environment variable configuration<br>
  *
  * {@code DNS_MEMBERSHIP_SERVICE_NAME=my-tomcat-app-membership }