Permissions
Org Admin | Team Manager (for assigned team) | Org Contributor | External Contributor |
View Create | View Create | View | No Access |
This article will guide you through the powerful "Custom Challenges" feature in devActivity, allowing you to create specific challenges tailored to any significant task or issue you want to see completed.
Overview
Custom Challenges provide a flexible way to incentivize and recognize contributions toward specific goals and tasks within your development workflow. They allow you to:
Direct Focus: Encourage your team to tackle specific issues or features by highlighting them as custom challenges.
Increase Motivation: Reward contributors for completing these challenges with XP and achievements, fostering a sense of accomplishment.
Boost Engagement: Make the development process more engaging by adding a gamified element with personalized challenges.
Creating a Custom Challenge
Navigate to the "Configure Challenges" Section: Go to the "Configure Challenges" section in the devActivity app.
Click "Create Custom Challenge": Locate the "Create Custom Challenge" button and click it.
Specify the GitHub Issue URL: Paste the URL of the GitHub issue related to the task you want to be completed. You can either use an existing issue or create a new one.
Configure the XP Reward:
Add: Input the number of XP points that will be awarded for completing the challenge.
Achievement Title: Provide a descriptive title for the achievement earned upon completing the challenge (e.g., "GitHub Guru").
Color: Choose a hexadecimal color code for the badge.
fa-icon: Select a Font Awesome icon for the badge (e.g., "fa-bolt").
Specify the Recipient: The XP and achievement will be awarded to the contributor who creates and merges the pull request associated with the specified GitHub issue.
Save Your Challenge: Click "Save" to create and activate your custom challenge.
Custom branded SVGs
Elevate your devActivity experience with custom branded SVGs for achievements and challenges. This premium feature lets you create unique, visually appealing badges that reflect your organization's identity.
Here's how to apply your custom SVG:
Specify your SVG URL: In the "Assign Custom Achievement" or "Custom Challenges" configuration
Issue Ideas for Custom Challenges
Leverage these ideas to identify issues that merit the creation of a custom challenge:
Open for a Long Time:
Filter:
is:open created:<2022-01-01Description: Lists issues that have been open for an extended period, indicating potential complexity or importance.
High Priority:
Filter:
label:priority-high is:openDescription: Identifies issues tagged with a high-priority label, signaling their significance.
Good First Issue:
Filter:
label:"good first issue" is:openDescription: Highlights issues suitable for newcomers, potentially deserving recognition upon successful completion.
Community Voted:
Filter:
label:"community-vote" is:openDescription: Flags issues that the community has voted on, showcasing their collective importance.
Milestone Target:
Filter:
milestone:"Next Release" is:openDescription: Lists issues targeted for an upcoming milestone, signifying their relevance to project goals.
Bug Fixes:
Filter:
label:bug is:openDescription: Focuses on issues labeled as bugs, as resolving them contributes to the project's stability.
Feature Requests:
Filter:
label:"feature-request" is:openDescription: Identifies issues tagged as feature requests, indicating potential for innovation and improvement.
High Impact:
Filter:
label:"high-impact" is:openDescription: Flags issues are marked as having a high impact, making them notable candidates for recognition.
Documentation Tasks:
Filter:
label:"documentation" is:openDescription: Highlights issues related to documentation, acknowledging the essential role of clear documentation in a project.
Security Issues:
Filter:
label:security is:openDescription: Lists issues tagged as security concerns, emphasizing the importance of addressing these for the project's integrity.
Best Practices and Use Cases
Align with Project Goals: Use Custom Challenges to prioritize tasks that directly contribute to your project's success.
Recognize Significant Contributions: Award substantial XP for completing challenging tasks to make them truly rewarding.
Promote Collaboration: Create custom challenges that involve multiple contributors, fostering teamwork and shared achievements.
Keep It Fun: Use creative achievement titles and icons to make the challenges engaging and memorable.
By leveraging the Custom Challenges feature, you can effectively guide your team's efforts, boost motivation, and create a more rewarding and engaging development environment.