Roles and Permissions
DevActivity.com provides a structured system of roles and permissions to ensure appropriate access and control over your organization's data and features. Understanding these roles is crucial for effective team management and data security.
Permissions Overview
For a detailed breakdown of all permissions associated with each role, please refer to our comprehensive permission table:
DevActivity Roles and Permissions Spreadsheet
Understanding Roles
Here's an overview of the different roles available on DevActivity.com and their respective capabilities:
Org Admin
The Org Admin holds the highest level of access, with full permissions across all aspects of DevActivity. This includes billing, user and team management, and settings configuration. Org Admins can also access all reports for all teams within the organization. This role is typically assigned to users who are GitHub organization admins and can also be manually assigned by other Org Admins.
Team Manager
Team Managers have focused access, primarily enabling them to view reports filtered by their assigned teams. They can also manage basic alert settings, perform contributor reviews, assign custom achievements, and create custom challenges. Additionally, they can utilize features like the Peer Recognition Awards widget. This role is assigned by an Org Admin.
External Manager
The External Manager role is similar in scope to the Team Manager, allowing access to team-filtered reports and management of basic alert settings, contributor reviews, and peer recognition. The key distinction is that External Managers are invited by an Org Admin via email and may not have a GitHub account or direct access to the GitHub organization. This role is ideal for HR personnel, Project Managers, or Client Representatives who need oversight without direct GitHub integration.
Org Contributor
Org Contributors are individuals imported from the GitHub organization. They can view reports relevant to their team, assign peer recognition awards to colleagues, and access embeddable widgets that represent their personal contributions, such as the XP Score Widget.
External Contributor
An External Contributor is someone who contributes to a repository on GitHub but is not (or is no longer) part of the organization. They do not have access to reports and data for private repositories. However, for public repositories, External Contributors can sign up to review their contributions, achievements, and individual challenges. They can also access embeddable widgets that represent their contributions.
Frequently asked questions
Where can I find a detailed overview of all permissions?
For a comprehensive overview of all permissions available for each role, please refer to the Google Spreadsheet linked in the 'Permissions Overview' section of this article.
Who can be assigned the Org Admin role?
The Org Admin role is typically assigned to users who are GitHub organization admins. It can also be manually assigned by another existing Org Admin.
What is the key difference between a Team Manager and an External Manager?
Both roles have similar management capabilities for assigned teams. The main difference is that an External Manager is invited via email and might not have a GitHub account or access to the GitHub organization, making it suitable for HR, Project Managers, or Client Representatives.
What can an Org Contributor do?
An Org Contributor can view reports related to their team, assign peer recognition awards to colleagues, and access embeddable widgets showcasing their contributions.
Can External Contributors view data for private repositories?
No, External Contributors do not have access to reports and data for private repositories. Their access is limited to reviewing contributions, achievements, and individual challenges in public repositories.
