👋 Welcome to the Role Reveal for Jira documentation!

Welcome to the knowledge base for Role Revealer for Jira – your go-to solution for clear visibility of project roles and permissions!

Managing roles and permissions in Jira can sometimes feel like untangling a bowl of spaghetti. But worry not! Role Revealer for Jira is here to cut through the complexity and serve up a clear, easily digestible overview. From the rookie developer to the seasoned project manager, everyone in your team gets to see who holds what role and the permissions associated with each - transparency at its best!

This knowledge base is designed to help you get the most out of Role Revealer. Whether you're setting up the app for the first time, need help troubleshooting an issue, or just want to learn more about our features, you've come to the right place.

Here you'll find step-by-step guides, FAQs, troubleshooting tips, and more. Each resource has been created with you in mind, ensuring that you'll find the answers you need quickly and easily.

Enjoy exploring, and remember, with Role Revealer for Jira, you're not just managing a project. You're empowering your team, enhancing collaboration, and driving project success.

Let's bring clarity to your projects, together!

🆘 Need help?

📖 User Guide

Welcome to the user guide for Role Revealer for Jira, your ultimate tool for demystifying project roles and permissions.

Role Revealer is designed to bring clarity to your project management by providing a transparent, user-friendly overview of who holds what roles within each project, as well as the permissions associated with each role. This means everyone on your team, not just admins, can gain clear insights into the project roles landscape.

With Role Revealer, you can navigate through your project with confidence, knowing exactly who can do what. No more guesswork or confusion - just simple, clear, and efficient project management.

In this guide, we will walk you through each feature of Role Revealer to ensure you can harness its full potential. Let's start revealing roles together!

Accessing Role Revealer

Navigate to your project and locate "Role Revealer" on the left sidebar. Clicking on this will open the Role Revealer page which features three tabs: Report, Analysis, and Settings.

Report Tab

This is your landing tab. It consists of two tables:

1. Roles and Users: This table displays all project roles along with the users and groups assigned to these roles. Roles are indicated with a star (⭐) symbol next to them if you, the current user, are assigned to them.

2. Permissions and Roles: This table lists permissions vertically and roles horizontally, with checks indicating the association of each permission with each role. Hovering over the permission name shows a tooltip with more details. The General column on the far right shows groups, users, and special actors associated with each permission, irrespective of role assignment.

Analysis Tab

This tab provides warnings, notices, and informational notes about the permissions granted within the project. It's your go-to for troubleshooting access and permission issues.

Settings Tab

This tab allows you to customize two settings on a per-user basis:

1. Hide the General column: This setting hides the General column in the Permissions and Roles table across all projects when you view Role Revealer.

2. Hide unassigned project roles: This setting conceals project roles that have no users or groups assigned.

Remember, these settings apply globally across all projects but only for your user account. For example, if you choose to hide the General column, it will be hidden for you in all projects, but other users will still see this column unless they too enable this setting.

Role Revealer for Jira is all about making your project role and permission management easy and transparent. Happy exploring!

🤔 FAQ

Below are some commonly asked questions and their answers to help you understand and navigate Role Revealer for Jira more effectively.

1. How do I access Role Revealer for Jira within my project?
   Navigate to your project and locate "Role Revealer" on the left sidebar. Clicking on it will open the Role Revealer page.

2. What does the star (⭐) symbol next to the role indicate?
   The star symbol (⭐) next to a role indicates that you, the current user, are assigned to that role in the project.

3. What information is shown in the Report tab?
   The Report tab provides a tabular overview of each project role, the users and groups assigned to these roles, and their associated permissions.

4. How do I understand the permissions each role has?
   In the Report tab, you'll find a table listing permissions vertically and roles horizontally. Checks indicate which permissions are associated with each role.

5. What is the General column in the Report tab?
   The General column indicates all the groups, users, and special actors that are also associated with each permission, regardless of the role assignment.

6. What can I find in the Analysis tab?
   The Analysis tab presents warnings, notices, and informative notes about the permissions granted within the project, which can be useful for troubleshooting access and permission issues.

7. What are the settings available in the Settings tab?
   The Settings tab allows you to hide the General column and/or hide project roles to which no users or groups are assigned. These settings apply globally across all projects but only for your user account.

8. Who can adjust the settings in the Settings tab?
   Every user can adjust the settings in the Settings tab. However, these changes will only affect your view and not the views of other users.

9. What do I do if my Role Revealer license is invalid?
   Only Jira admins can update the license. If you encounter an invalid license message, please ask your Jira admin to renew or validate the license.

10. Who can view the Role Revealer page within a project?
    Role Revealer is designed to bring transparency to your project team. This means that every user within the project can access the Role Revealer page and view role and permission information.

For further questions or assistance, please reach out to our support team. We're here to help you reveal roles like a pro!