Skip to content

docs: add Dashboard RBAC permissions matrix#3005

Merged
manovotny merged 17 commits intomainfrom
manovotny/dashboard-rbac-docs
Feb 6, 2026
Merged

docs: add Dashboard RBAC permissions matrix#3005
manovotny merged 17 commits intomainfrom
manovotny/dashboard-rbac-docs

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?

  • Updated /docs/guides/dashboard/overview with detailed permissions breakdown for Owner, Admin, Developer, Support, and Viewer roles using <ComparisonTable> component
  • Added <ComparisonTable> component documentation to CONTRIBUTING.md with usage examples and related components (<CompareYes />, <CompareNo />, <ComparePartial>, <CompareNotApplicable />, <ChangeTag />)

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 <noreply@anthropic.com>
@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 6, 2026 1:35am

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.
@manovotny manovotny marked this pull request as ready for review February 5, 2026 16:58
@manovotny manovotny requested a review from a team as a code owner February 5, 2026 16:58
manovotny and others added 2 commits February 5, 2026 15:40
Update CONTRIBUTING.md to document the new CompareNotApplicable
component and fix CompareMaybe default character (◐ instead of —).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Change CompareMaybe to ComparePartial in CONTRIBUTING.md
- Replace "Not applicable" text with <CompareNotApplicable /> component
  in dashboard overview.mdx

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
SarahSoutoul and others added 2 commits February 5, 2026 15:58
…dd CompareNotApplicable, remove ChangeTag

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
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 pretty nice, i think this is great layout

manovotny and others added 2 commits February 5, 2026 19:26
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@manovotny manovotny merged commit 9f9cf9e into main Feb 6, 2026
8 checks passed
@manovotny manovotny deleted the manovotny/dashboard-rbac-docs branch February 6, 2026 01:48
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