There is some best practice for the documentation of values with helm. Could be a interesting things to follow for the future : https://helm.sh/docs/chart_best_practices/values/#document-valuesyaml