Use helm-docs?

[maxnoe]

https://github.com/norwoodj/helm-docs

We use it with pre-commit to guarantee up-to-date readmes and we found it also integrates nicely into sphinx docs using myst-parser:

Helm Chart
==========


.. include:: ../chart/README.md
   :parser: myst_parser.sphinx_

You can add descriptions to values using magic comments, see the README of helm-docs.

It would be very nice if rucio could also adapt this, as the values of chart dependencies are included automatically when creating helm docs for parent charts.