Improve helm lint documentation clarity

[myk0la-b]

Clarified helm lint --with-subcharts option documentation

Please note helm/helm#12027 -- abovementioned unclear part caused many people to struggle

Please help with other languages documentatiton

[astellingwerf]

To me, the documentation is still unclear: I don't understand what this option does, especially since the linting behavior is so different from helm template. It seems impossible to lint the subscharts if they use template provided by the superchart.

[myk0la-b]

@astellingwerf, so the thing I am trying to emphasize there is that when you run helm lint without the --with-subcharts option, your subchart will be linted as part of the superchart. i.e. it exactly does

lint the subscharts if they use template provided by the superchart

But on the other hand, when the --with-subcharts option is used, the subchart would be additionally linted as an independent entity.

[mattfarina]

This document is generated from Helm itself. So are all the files in this directory.

It needs to be changed at https://github.com/helm/helm/blob/ecc4adee692333629dbe6343fbcda58f8643b0ca/cmd/helm/lint.go#L149.

Please update it in the other location.

[andrask]

Additionally, the wording is still hazy. Maybe something like this could be better:

Suggested change

	--with-subcharts lint subcharts as independent charts (note that without this option, the chart will be validated as a whole, including subcharts as its part)
	--with-subcharts lint subcharts separately from the parent chart

To be honest, this option's name is already misleading. But that's much harder to change.