Annotation `resource.kubernetes.io/pod-claim-name` not registered or documented

[sftim]

This is a Bug Report

Problem: The annotation resource.kubernetes.io/pod-claim-name is unregistered, but used in Kubernetes code.

The code comment says:

    // podResourceClaimAnnotation is the special annotation that generated
    // ResourceClaims get. Its value is the pod.spec.resourceClaims[].name
    // for which it was generated. This is used only inside the controller
    // and not documented as part of the Kubernetes API.

However, we don't have a mechanism to register annotations that are not also documented. So, it needs registering.

Proposed Solution: Register the annotation, by mentioning it in Well-Known Labels, Annotations and Taints.

Page to Update: https://kubernetes.io/docs/reference/labels-annotations-taints/

Additional Information: /sig node Required for https://github.com/kubernetes/enhancements/issues/3063

[T-Lakshmi]

/assign

[dipesh-rawat]

/priority backlog /triage accepted

[sftim]

/lifecycle frozen

[abhilasha2418]

/assign