Categorize Permissions

Problem

We are looking to move our current group and project permissions into the UI as part of our work to introduce RBAC/Fine-grained permissions into GitLab.

Currently, permissions are documented in two, large tables in our docs. Here's a small visual of how it looks:

Before bringing these tables into the UI, can we re-evaluate how they are organized to provide better readability?

Proposal

We've gone through the current permissions tables and have done the following:

• Taken the existing groups of permissions items and further consolidated them, grouping like items together.
• Consolidated the existing (and separate) project and group tables into a single table, using the Namespace framework.
• Grouped like actions together, and listed them within each section from least to most "severe" (ie, from View to Delete).
• Ensured that the groups we're presenting both align with how we group things in the product itself, and with how an Admin would need them grouped when creating roles aligning to the various personas we serve.

The current list is visible in Figma, but here's a visual for how it's breaking down thus far:

Figma work file

Please also see the RBAC parent epic for more details about the problem space, and previous research.