atharvalade commented on PR #2976:
URL: https://github.com/apache/iggy/pull/2976#issuecomment-4094371057

   > Also, should we clean up comments from values.yaml, otherwise there will 
always be documentation drift between two
   
   Good point. For this PR, the `values.yaml` comment and `README` are 
consistent (both describe `serviceMonitor` as opt-in for Prometheus Operator 
users), so there's no immediate drift. But you're right that maintaining 
descriptions in both places long-term is fragile. The # -- comments in 
values.yaml follow the [helm-docs](https://github.com/norwoodj/helm-docs) 
convention -- the standard approach is to auto-generate the `README` parameter 
table from those comments so there's a single source of truth. That would be a 
nice follow-up but shouldn't block this PR. @avirajkhare00 


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to