Skip to content

Docs: Update CLAUDE.md and rbac.md for accuracy #770

Description

@pascazzioIsAbyayalan

Description

Multiple documentation inconsistencies found:

  1. CLAUDE.md - Missing MCPServerRegistration from MCP resources list
  2. CLAUDE.md - MCPOverviewPage description is outdated
  3. 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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationtriage/acceptedReviewed, prioritised, and ready for work

    Type

    No type

    Projects

    • Status
      Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions