I have been looking at https://kubernetes.io/docs/reference/access-authn-authz/ recently and wanted to raise something for discussion.
A lot of the pages in this directory read more like "concept" than "reference". They explain how authentication, authorization, and admission control work, rather than being lookup-style references. Moving some of them under https://kubernetes.io/docs/concepts/security/ or https://kubernetes.io/docs/concepts/policy/ might be worth considering.
Curious whether the current layout is intentional, or if there would be interest in restructuring.
/assign
/kind cleanup
/language en
I have been looking at https://kubernetes.io/docs/reference/access-authn-authz/ recently and wanted to raise something for discussion.
A lot of the pages in this directory read more like "concept" than "reference". They explain how authentication, authorization, and admission control work, rather than being lookup-style references. Moving some of them under https://kubernetes.io/docs/concepts/security/ or https://kubernetes.io/docs/concepts/policy/ might be worth considering.
Curious whether the current layout is intentional, or if there would be interest in restructuring.
/assign
/kind cleanup
/language en