kubernetes / kubernetes/website
Wrong subject array hyperlink for ClusterRoleBinding and RoleBinding in Api Reference
- Dominant language
- HTML
- Stars
- 5.4k
- Forks
- 15.7k
- Avg merge
- 4d 18h
- Merged PRs (30d)
- 204
Description
**This is a Bug Report**
**Problem:**
For ClusterRoleBinding and RoleBinding, the _Subject array_ hyperlink redirects to the subject definition for FlowSchema which isn't the correct object (different structure, lacks the fields: apiVersion, namespace)
Steps to reproduce:
Click on hyperlink _Subject array_ in :
- https://kubernetes.io/docs/reference/kubernetes-api/rbac/role-binding-v1/
- https://kubernetes.io/docs/reference/kubernetes-api/rbac/cluster-role-binding-v1/
Compare values with kubectl explain commands:
kubectl explain clusterrolebinding.subjects
kubectl explain rolebinding.subjects
**Proposed Solution:**
Create a dedicated RBAC subject definition page that would be the target of both hyperlinks.
**Page to Update:**
https://kubernetes.io/docs/reference/kubernetes-api/rbac/role-binding-v1/
https://kubernetes.io/docs/reference/kubernetes-api/rbac/cluster-role-binding-v1/
Contributor guide
Research direction
Start with the RoleBinding and ClusterRoleBinding API reference pages named in the issue, then compare their Subject links with kubectl explain clusterrolebinding.subjects and kubectl explain rolebinding.subjects. Locate the source for those pages, create the dedicated RBAC subject definition target, and update both hyperlinks so they show the correct fields.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100