Permissions
Org Admin | Team Manager (for assigned team) | Org Contributor | External Contributor |
View Edit Create Custom | No access | No access | No access |
This article guides you through configuring challenges within devActivity, a powerful tool to gamify your development workflow and motivate your team. Challenges are goals or tasks that users can complete to earn Experience Points (XP) and unlock Achievements.
Overview
This section covers the process of configuring challenges, including:
Accessing the Challenges Configuration screen
Understanding different challenge categories
Configuring challenge goals and rewards
Core Features and Functionalities
Accessing the Challenges Configuration Screen
Log in to devActivity: Access your devActivity dashboard.
Navigate to Settings: Click on the Settings button in the top-right corner of your dashboard.
Select Challenges Configuration: Click on the Challenges Configuration option from the settings menu.
Understanding Challenge Categories
The Challenges Configuration screen displays a list of preset challenges categorized into four types:
Onboarding Challenges (One-Time): These challenges are designed to help new users get started with devActivity and earn XP as they complete the steps. Completing these challenges will help users acclimate to the app and encourage them to explore its features.
Individual Challenges (Monthly): These challenges are designed to motivate users to contribute regularly and earn XP based on their performance. Completing these challenges helps users track their progress and strive for continuous improvement.
Team Challenges (Monthly): These challenges are designed to foster collaboration and healthy competition among teams. Completing these challenges promotes teamwork and collective achievement.
Accumulative Challenges: These challenges are designed for long-term engagement and recognize users for their sustained contributions over time. Completing these challenges instills a sense of progress and loyalty among users.
Configuring Challenge Goals and Rewards
Each challenge can be enabled or disabled using the toggle switch next to it. Clicking on a challenge reveals a configuration window where administrators can:
Configure Challenge Reward: Assign a corresponding reward in the form of experience points (XP). Rewards can be a fixed number of XP or a percentage of the user's total monthly earned XP.
Configure Challenge Goal: Define the specific target for the challenge, such as a minimum XP/Contribution Score or a maximum Cycle Time.
Here is a list of the categories and challenges, along with a description and benefits of each:
ONBOARDING CHALLENGES (ONE-TIME)
These challenges are designed to help new users get started with devActivity and earn XP as they complete the steps. Completing these challenges will help users acclimate to the app and encourage them to explore its features.
First Commit Added: Awarded when a user adds their first commit.
Benefit: Encourages users to start contributing to code repositories.
First Pull Request Pushed: Awarded when a user pushes their first PR.
Benefit: Encourages users to share their code and collaborate with others.
First Code Review Done: Awarded when a user completes their first code review.
Benefit: Encourages users to participate in code quality assurance.
First Comment Added: Awarded when a user adds their first comment to a PR or issue.
Benefit: Encourages users to communicate and provide feedback.
First Issue Closed: Awarded when a user closes their first issue.
Benefit: Encourages users to take ownership of issues and contribute to their resolution.
First Issue Created: Awarded when a user creates their first issue.
Benefit: Encourages users to report bugs and suggest improvements.
First Alert Resolved: Awarded when a user resolves their first alert.
Benefit: Encourages users to address potential issues promptly.
First Recognition Award Assigned: Awarded when a user receives their first recognition award.
Benefit: Provides recognition for a job well done and encourages users to continue their positive contributions.
First Recognition Award Received: Awarded when a user is assigned their first recognition award.
Benefit: Provides recognition for a job well done and encourages users to continue their positive contributions.
First Performance Review Created: Awarded when a user creates their first performance review.
Benefit: Encourages users to actively participate in the performance review process.
INDIVIDUAL CHALLENGES (MONTHLY)
These challenges are designed to motivate users to contribute regularly and earn XP based on their performance. Completing these challenges helps users track their progress and strive for continuous improvement.
XP/Contribution Score is above [variable]: Awarded when a user's XP or contribution score exceeds a predefined threshold.
Benefit: Encourages users to maintain a high level of activity and contribution.
Commit Count is above [variable]: Awarded when a user makes a certain number of commits within a month.
Benefit: Encourages consistent coding activity.
PR Count is above [variable]: Awarded when a user submits a certain number of PRs within a month.
Benefit: Encourages active code sharing and collaboration.
Cycle Time is below [variable]: Awarded when a user consistently completes tasks within a specified timeframe.
Benefit: Promotes efficiency and timely delivery.
Review Time is below [variable]: Awarded when a user consistently reviews code within a specified timeframe.
Benefit: Encourages prompt feedback and efficient code review cycles.
10 PRs in a row with no errors: Awarded when a user achieves a streak of 10 consecutive PRs without any errors.
Benefit: Promotes code quality and reduces the likelihood of bugs.
More than 5 Recognition Awards assigned: Awarded when a user receives more than 5 recognition awards within a month.
Benefit: Recognizes and rewards exceptional performance and contributions.
Fastest PR: Awarded to the user who submits the fastest PR.
Benefit: Encourages efficiency and speed in delivering code changes.
Fastest Review: Awarded to the user who completes the fastest code review.
Benefit: Promotes timely feedback and efficient code review cycles.
Oldest Issue Closed: Awarded to the user who closes the oldest outstanding issue.
Benefit: Encourages addressing long-standing issues and reducing technical debt.
Most Alerts Solved: Awarded to the user who resolves the most alerts.
Benefit: Promotes proactive issue identification and resolution.
Most Comments Added: Awarded to the user who adds the most comments to PRs and issues.
Benefit: Encourages active communication and feedback.
Most Issues Closed: Awarded to the user who closes the most issues.
Benefit: Recognizes contributions to issue resolution and project progress.
Closed Most Issues Labeled 'Bug': Awarded to the user who closes the most issues labeled as bugs.
Benefit: Highlights contributions to bug fixing and code stability.
TEAM CHALLENGES (MONTHLY)
These challenges are designed to foster collaboration and healthy competition among teams. Completing these challenges promotes teamwork and collective achievement.
XP/Contribution Score is above [variable]: Awarded when a team's total XP or contribution score surpasses a predefined threshold.
Benefit: Encourages collective effort and high performance within the team.
Cycle Time is below [variable]: Awarded when a team consistently completes tasks within a specified timeframe.
Benefit: Promotes team efficiency and timely project delivery.
ACCUMULATIVE CHALLENGES
These challenges are designed for long-term engagement and recognize users for their sustained contributions over time. Completing these challenges instills a sense of progress and loyalty among users.
Years of Contribution: Awarded based on the number of years a user has been actively contributing.
Benefit: Recognizes and rewards long-term commitment and dedication.
Recognition Award Club: Awarded to users who consistently earn recognition awards.
Benefit: Celebrates and acknowledges sustained high performance.
Contrib Club: Awarded to users who consistently make significant contributions.
Benefit: Recognizes and appreciates consistent contributions over an extended period.
Best Practices and Use Cases
Tailor Challenges to Your Needs: Customize challenges to align with your team's goals and priorities. For example, if you prioritize code quality, focus on challenges related to code reviews and bug fixes.
Set Realistic Goals: Ensure that challenge goals are achievable and motivating. Avoid setting overly challenging goals that may discourage participation.
Provide Clear Instructions: Clearly communicate challenge requirements and guidelines to users. This ensures that everyone understands what is expected of them.
Use Challenges for Onboarding: Onboarding challenges can help new users get familiar with the platform and contribute effectively.
Recognize Achievements: Celebrate challenge completions and acknowledge users' achievements. This reinforces positive behavior and encourages continued engagement.
Track Progress: Monitor challenge progress and make adjustments as needed. This helps ensure that challenges remain relevant and motivating for your team.
By effectively configuring challenges, you can create a dynamic and engaging environment that motivates your team to contribute, collaborate, and achieve their best.