Address code review feedback - add clarifying comments

Co-authored-by: SRF-Audio <16975040+SRF-Audio@users.noreply.github.com>

Author: Copilot

argocd/apps/platform/mqtt-broker.yml

@@ -19,6 +19,8 @@ spec:
           usersExistingSecret: mosquitto-auth
           users:
             - username: admin
+              # Password field is ignored when usersExistingSecret is set
+              # The actual password comes from the mosquitto-auth secret
               password: ""
               acl:
                 - topic: "#"

k8s/infra-mqtt/onepassword/mosquitto-auth.yml

@@ -3,7 +3,7 @@
 # infra-mqtt namespace. The 1Password item must have a field named
 # "passwords.conf" containing the mosquitto password file content
 # (username:hash format, one per line).
-# Generate hashes using: mosquitto_passwd -c /tmp/passwd username
+# Generate hashes using: mosquitto_passwd -c /tmp/mosquitto_passwd username
 apiVersion: onepassword.com/v1
 kind: OnePasswordItem
 metadata: