Docs: Update CLAUDE.md and rbac.md for accuracy
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 78/100
- Issue type
- Documentation
- Clarity
- Mostly clear
- Activity status
- Active
- Domain
- documentation
Research direction
Start with CLAUDE.md:65-68 and 145-148, then inspect docs/rbac.md:7 and the implementation of the #ALL_NS# behavior. Update the MCP resource list and MCPOverviewPage description, and make the all-namespaces documentation match the implementation; verify all three locations for consistency.
Written by the indexing model from the issue text.
Description
Description
Multiple documentation inconsistencies found:
- CLAUDE.md - Missing
MCPServerRegistrationfrom MCP resources list - CLAUDE.md -
MCPOverviewPagedescription is outdated - docs/rbac.md - Contradictory all-namespaces behavior description
Current Behaviour
CLAUDE.md:65-68 - MCP Resources section lists:
- ✅
MCPGatewayExtension - ✅
ReferenceGrant - ❌ Missing:
MCPServerRegistration(actually used in MCPOverviewPage)
CLAUDE.md:145-148 - Says:
"Empty state entry point for MCP Management with link to setup wizard"
But MCPOverviewPage now renders:
- Health statistics
- Resource tables (extensions, servers, grants)
- Attached policies
- RBAC-gated panels
- Empty state is just one conditional branch
docs/rbac.md:7 - Says:
"all-namespaces checks are cluster-scoped"
This contradicts actual #ALL_NS# implementation.
Expected Behaviour
Fix 1: Add to CLAUDE.md MCP Resources:
14. **MCPServerRegistration** (`mcp.kuadrant.io/v1`) - MCP server configuration and registration
Fix 2: Update CLAUDE.md MCPOverviewPage description:
**MCPOverviewPage**: MCP management dashboard with gateway/server health statistics, resource tables (MCPGatewayExtension, MCPServerRegistration, ReferenceGrant), attached policies list, and RBAC-gated panels. Shows setup wizard empty state when no extensions exist.
Fix 3: Audit and fix docs/rbac.md all-namespaces behavior to match implementation.
Locations
CLAUDE.md:65-68(MCP resources)CLAUDE.md:145-148(MCPOverviewPage)docs/rbac.md:7(all-namespaces)
Related
CodeRabbit comment in PR #734
- Dominant language
- TypeScript
- Stars
- 10
- Forks
- 65
- Avg merge
- 2d 14h
- Merged PRs (30d)
- 44
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Kuadrant/kuadrant-console-plugin
-
e2e nightly-infrastructure
Difficulty 4/5 3-5 days Newbie friendliness 25/100
-
bug triage/accepted
Kuadrant/kuadrant-console-plugin#847 · 1 assignee ·
-
e2e nightly-failure
Difficulty 4/5 3-5 days Newbie friendliness 35/100
-
triage/needs-triage
Difficulty 3/5 1-2 days Newbie friendliness 68/100
Kuadrant/kuadrant-console-plugin#835 · 1 comment ·
-
enhancement triage/accepted
Kuadrant/kuadrant-console-plugin#834 · 1 comment · 1 assignee ·
All issues in Kuadrant/kuadrant-console-plugin
Similar issues
-
calcite-components needs triage refactor
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Esri/calcite-design-system#15203 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 91/100
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Automattic/studio#4908 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 90/100