Skip to content

Conversation

@manovotny
Copy link
Contributor

@manovotny manovotny commented Jan 27, 2026

Warning

https://github.com/clerk/clerk/pull/2034 will need to be merged first with new MDX components.

🔎 Previews:

What does this solve?

  • Provides comprehensive documentation of the Dashboard's role-based access control (RBAC) permissions matrix to help users understand what each role can and cannot do.

What changed?

  • Added new RBAC documentation page at /docs/guides/dashboard/rbac with detailed permissions breakdown for Owner, Admin, Developer, Support, and Member roles
  • Added <ComparisonTable> component documentation to CONTRIBUTING.md with usage examples and related components (<CompareYes />, <CompareNo />, <CompareMaybe>, <ChangeTag />)
  • Updated docs/manifest.json to include the new RBAC matrix page in the Dashboard guides section

Adds comprehensive documentation of the Dashboard's role-based access control (RBAC) permissions matrix with detailed breakdowns of each role (Owner, Admin, Developer, Support, Member) and their permissions across different features.

Also documents the new <ComparisonTable> component and related utilities for creating feature comparison tables.

Co-Authored-By: Claude Haiku 4.5 <[email protected]>
@vercel
Copy link

vercel bot commented Jan 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview Feb 3, 2026 8:23am

Request Review

This commit overhauls the RBAC documentation to reflect recent changes in dashboard roles and permissions.

Key changes include:
- Renamed 'Member' role to 'Viewer'.
- Introduced a new 'Admin' role.
- Introduced a new 'Developer' role.
- Updated the permissions matrix to remove 'Key' column and align with new roles.
- Added detailed descriptions for each role, outlining responsibilities, permissions, and limitations.
- Replaced 'Differences from current state' with 'Role details' and 'Frequently asked questions' sections for better clarity and structure.
Copy link
Member

@rafaelrcamargo rafaelrcamargo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good! 😅

Updated the description and limitations for the Admin role in the RBAC documentation. Previously, the documentation stated that Admins could not manage organization members; however, this is incorrect. This change removes that misleading information to accurately reflect the permissions of the Admin role, ensuring the documentation is precise and up-to-date.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants