Add admin dashboard user permissions documentation

admin-dashboard/user-permissions.mdx

@@ -0,0 +1,46 @@
+---
+title: User permissions
+description: 'Understanding different user roles and permissions in the admin dashboard'
+---
+
+The admin dashboard provides different permission levels to control what users can access and manage within your organization.
+
+## Permission levels
+
+### Members
+
+Members have access to core functionality needed for day-to-day development work:
+
+- **Manage repositories** - Add, remove, and configure repositories for code review
+- **Configure integrations** - Set up and manage GitHub, GitLab, and other service integrations  
+- **View analytics** - Access code review metrics, usage statistics, and performance data
+
+### Admins
+
+Admins have all member permissions plus additional administrative capabilities:
+
+- **Manage user roles** - Assign and modify user permission levels within the organization
+- **Manage billing** - Access billing information, update payment methods, and manage subscriptions
+
+### Owners
+
+Owners have the highest level of access with all admin permissions plus:
+
+- **Delete organization** - Permanently remove the organization and all associated data
+
+<Warning>
+Organization deletion is irreversible and will permanently remove all repositories, settings, analytics data, and user access.
+</Warning>
+
+## Managing user permissions
+
+To modify user permissions in your organization:
+
+1. Navigate to the admin dashboard
+2. Go to the user management section
+3. Select the user whose permissions you want to change
+4. Choose the appropriate permission level (Member, Admin, or Owner)
+
+<Note>
+Only Admins and Owners can modify user permissions. Members cannot change permission levels for any users.
+</Note>

docs.json

@@ -17,6 +17,7 @@
             "pages": [
               "introduction",
               "developer-quick-reference",
+              "admin-dashboard/user-permissions",
               "code-review-bot/getting-started",
               "code-review-bot/key-features",
               "code-review-bot/best-practices",
@@ -130,4 +131,4 @@
       "destination": "/code-review-bot/custom-context"
     }
   ]
-}
+}