Published docs out of sync with comments in API definition

[craigbox]

https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.ParentReference states

ParentReference identifies an API object (usually a Gateway) that can be considered a parent of this resource (usually a route). The only kind of parent resource with “Core” support is Gateway. This API may be extended in the future to support additional kinds of parent resources, such as HTTPRoute.

which has not been updated for the fact that in v1, Service is a supported parent also. This is correctly set in https://github.com/kubernetes-sigs/gateway-api/blob/main/apis/v1/shared_types.go#L23-L25, so perhaps the docs just need to be rebuilt?

[kundan2707]

/assign

[amitmaurya07]

Hello @kundan2707, if you are not working on this issue.
Can I take this issue @craigbox ?

[youngnick]

/assign @amitmaurya07

Please feel free.

[amitmaurya07]

Thanks @youngnick
I'll start working on it.

[kundan2707]

/unassign

[craigbox]

@amitmaurya07 how are you going with this issue?

[k8s-triage-robot]

The Kubernetes project currently lacks enough contributors to adequately respond to all issues.

This bot triages un-triaged issues according to the following rules:

• After 90d of inactivity, lifecycle/stale is applied
• After 30d of inactivity since lifecycle/stale was applied, lifecycle/rotten is applied
• After 30d of inactivity since lifecycle/rotten was applied, the issue is closed

You can:

• Mark this issue as fresh with /remove-lifecycle stale
• Close this issue with /close
• Offer to help out with Issue Triage

Please send feedback to sig-contributor-experience at kubernetes/community.

/lifecycle stale

[craigbox]

FWIW #3400 made a change to shared_types.go recently and that change is reflected in the docs.

[youngnick]

Yes, checking the current docs, they correctly reflect that Service is also a supported parent. https://gateway-api.sigs.k8s.io/reference/spec/#parentreference

I think we can close this one. @craigbox please comment if you don't agree and I'll reopen.

/close

[k8s-ci-robot]

@youngnick: Closing this issue.

In response to this:

Yes, checking the current docs, they correctly reflect that Service is also a supported parent. https://gateway-api.sigs.k8s.io/reference/spec/#parentreference

I think we can close this one. @craigbox please comment if you don't agree and I'll reopen.

/close

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.