docs: Show GatewayAPI APIs in EG docs

[arkodg]

Description:

Describe the issue.

Currently the API reference only shows Envoy Gateway extensions https://gateway.envoyproxy.io/latest/api/

We should also show Gateway API reference within Envoy Gateway to provide a better experience https://gateway-api.sigs.k8s.io/reference/spec/

[optional Relevant Links:]

Any extra documentation required to understand the issue.

[arkodg]

@zirain @Xunzhuo thoughts on the best way to do this ?
lets copy these over from upstream https://github.com/kubernetes-sigs/gateway-api/tree/main/site-src/api-types into https://github.com/envoyproxy/gateway/tree/main/site/content/en/latest/api ?

[zirain]

that make sense

[Xunzhuo]

When should we update the copied files? Each time we bump the gwapi version ?

[arkodg]

@Xunzhuo we could add the new make target that does the fetch + copy and add it into existing docs pipeline
and we can use the go mod version when fetching, so it will ideally only change when we bump gwapi version

[Xunzhuo]

Yep, let me add it.

[github-actions]

This issue has been automatically marked as stale because it has not had activity in the last 30 days.

[shawnh2]

Seems we can do something as in #3416, to link the GW-API type to relevant field.

[github-actions]

This issue has been automatically marked as stale because it has not had activity in the last 30 days.

[StevenACoffman]

/unstaleify

[github-actions]

This issue has been automatically marked as stale because it has not had activity in the last 30 days.

[arkodg]

hey @zirain can you hep with this one ?

[zirain]

wait for upstream: kubernetes-sigs/gateway-api#3204

[github-actions]

This issue has been automatically marked as stale because it has not had activity in the last 30 days.

[arkodg]

@zirain looks like 3204 is probably not going to land anytime soon
can we generate https://github.com/kubernetes-sigs/gateway-api/blob/main/site-src/reference/spec.md as part of docs CI and save the content with make generate . It will only change when gateway-api versions change

[github-actions]

This issue has been automatically marked as stale because it has not had activity in the last 30 days.