Fixed KafkaAgent Javadoc (#12370)

Signed-off-by: Paolo Patierno <ppatierno@live.com>

Author: ppatierno

cluster-operator/src/main/java/io/strimzi/operator/cluster/operator/assembly/KafkaReconciler.java

@@ -288,7 +288,7 @@ private Future<Void> updateKafkaAutoRebalanceStatus(KafkaStatus kafkaStatus) {
         Set<Integer> addedBrokers = kafka.addedNodes().stream().filter(NodeRef::broker).map(NodeRef::nodeId).collect(Collectors.toSet());
 
         // if added brokers list contains all desired, it's a newly created cluster so there are no actual scaled up brokers.
-        // when added brokers list has fewer nodes than desired, it actually containes the new ones for scaling up
+        // when added brokers list has fewer nodes than desired, it actually contains the new ones for scaling up
         Set<Integer> scaledUpBrokerNodes = addedBrokers.containsAll(desiredBrokers) ? Set.of() : addedBrokers;
 
         KafkaRebalanceUtils.updateKafkaAutoRebalanceStatus(kafkaStatus, kafkaAutoRebalanceStatus, scaledUpBrokerNodes);
@@ -314,7 +314,7 @@ protected Future<Void> modelWarnings(KafkaStatus kafkaStatus) {
     /**
      * Initialize the TrustSet and PemAuthIdentity to be used by TLS clients during reconciliation
      *
-     * @return Completes when the TrustStore and PemAuthIdentity have been created and stored in a record
+     * @return Completes when the TrustSet and PemAuthIdentity have been created and stored in a record
      */
     protected Future<Void> initClientAuthenticationCertificates() {
         return ReconcilerUtils.coTlsPemIdentity(reconciliation, secretOperator)

kafka-agent/src/main/java/io/strimzi/kafka/agent/KafkaAgent.java

@@ -89,10 +89,10 @@ public class KafkaAgent {
     /**
      * Constructor of the KafkaAgent
      *
-     * @param client       Keystore containing the broker certificate
-     * @param caCertSecretName       Password for keystore
-     * @param nodeCertSecretName     Truststore containing CA certs for authenticating clients
-     * @param namespace     Password for truststore
+     * @param client                Kubernetes client instance
+     * @param caCertSecretName      CA certificate Secret name
+     * @param nodeCertSecretName    Node certificate Secret name
+     * @param namespace             Namespace where the Kafka cluster is running
      */
     /* test */ KafkaAgent(KubernetesClient client, String caCertSecretName, String nodeCertSecretName, String namespace) {
         this.caCertSecret = getKubernetesSecret(client, caCertSecretName, namespace);
@@ -106,6 +106,8 @@ private Secret getKubernetesSecret(KubernetesClient client, String caCertSecretN
     /**
      * Constructor of the KafkaAgent
      *
+     * @param caCertSecret                  CA certificate Secret
+     * @param nodeCertSecret                Node certificate Secret
      * @param brokerState                   Current state of the broker
      * @param remainingLogsToRecover        Number of remaining logs to recover
      * @param remainingSegmentsToRecover    Number of remaining segments to recover