docs: Marker docs about required fields are not fully accurate

[ahmetb]

docs: Marker docs about required fields are not fully accurate

[camilamacedo86]

Hi @ahmetb,

By defining a String spec with "" you are defining a string with an empty value.
So, it does not seem to be an error but the expected behaviour.

In your case scenario, seems that you want ensure that:
a) The String spec exist ( +kubebuilder:validation:Required )
b) If its value is bigger than X size ( +kubebuilder:validation:MinLength )

So you would need to use both.

However, if you think that the description or behaviour should be changed then can you please raise an issue against: https://github.com/kubernetes-sigs/controller-tools.

See that the markers are defined in this project. Kubebuilder uses controller-gen (controller-tools) to perform these validations. Indeed the doc is generated automatically from the descriptions added in controller-tools, see: https://github.com/kubernetes-sigs/controller-tools/blob/f185f4d8e8f1c0a006fee16fbb80c832594a1fcf/pkg/crd/markers/validation.go#L77

Therefore, I am closing this one.
But if you need, please feel free to reopen this one.