search

kubernetes-sigs / reference-docs

Tools to build reference documentation for Kubernetes APIs and CLIs.
Apache License 2.0
87 stars 102 forks source link

NetworkPolicy v1 is out of order in Cluster APIs section #355

Open RTann opened 3 months ago

RTann commented 3 months ago

Reference: https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.30/#networkpolicy-v1-networking-k8s-io

I'm looking at the v1.30 docs (I also saw this is the case for v1.28 and v1.29), and it looks like NetworkPolicy is out of place, as it's placed at the end, and the docs seem to be following an alphabetical order scheme. I'd adjust this, but I'm not sure if the files are generated from elsewhere nor how many versions are worth even addressing. Thanks.

RTann commented 3 months ago

Looks like I can just update https://github.com/kubernetes-sigs/reference-docs/blob/master/gen-apidocs/config/config.yaml for v1.30, but I'm not sure how many versions back I should bother. Maybe just the supported versions (v1.27 - v1.30)?

tengqm commented 3 months ago

Maybe just the supported version should be fine.

RTann commented 3 months ago

I created a PR, but I opted to close it because I do not wish to sign the agreement at this time.

sftim commented 3 weeks ago

/triage accepted