kubernetes / kubernetes/website

Wrong subject array hyperlink for ClusterRoleBinding and RoleBinding in Api Reference

Open
#56,576 2 comments 0 reactions 0 assignees View on GitHub
kind/bug priority/backlog triage/accepted
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.