Comments from #10752 (comment):

• the values.yaml file is missing comments for most values
• more general explanations are pretty sparse (it seems we currently only have short paragraphs in the README)
• examples of common environments are missing (GKE, EKS, On-Prem)
• provide upgrade guides for major/minor version bumps of the chart

All of this should be initially included in README.md and ideally we should have some sort of documentation for Helm Chart here: https://airflow.apache.org/docs/ (maybe https://airflow.apache.org/docs/helm-chart/stable)

We can also autogenerate some docs based on values.schema.json as mentioned in #11077