Autogenerated reference doc for policies is misleading

[Automaat]

Kuma Version

all

Describe the bug

Right now when we autogenerate reference doc for policy we do it from generic API for policy, so all targetRefs can accept all kinds, also we list all fields from targetRef. This ends up with a situation where our customers try to build policies based on this reference, but they end up debugging their policies based on errors from validators.

Expected behavior

We should properly generate this reference, or we should generate reference only for default fields which contains actual configuration of given policy

Additional context (optional)

https://kongstrong.slack.com/archives/C0164PPUSFP/p1738887785829129

https://kuma.io/docs/2.9.x/policies/meshloadbalancingstrategy/#all-policy-options

[michaelbeaumont]

I think we could fix the CRDs, the source of everything.

[lahabana]

@Automaat this is more a Kuma issue no?

[Automaat]

@lahabana If we only render stuff that is fully generated by kuma, then probably this should be a Kuma issue

[lukidzi]

Triage: For now. we are going to remove targetRef from this place and we can link to the targetRef docs. Future, should we have policy-specific targetRef docs(manually or automatically )? After removing an open issue to improve policy specific targetRef