Permissions
Org Admin | Team Manager (for assigned team) | Org Contributor | External Contributor |
View Create | View Create | View | View assigned achievements |
This article explains how to use the "Custom Achievements" feature in devActivity to recognize and reward contributors for their unique and valuable contributions to your project.
Overview
Custom Achievements are a powerful tool for recognizing exceptional contributions beyond the standard achievements earned through challenges. They allow you to create personalized awards for specific tasks, initiatives, or skills that are important to your project.
Core Features and Functionalities
Creating a Custom Achievement:
Navigate to the "Achievements" section of your devActivity dashboard.
Click on the "Assign Custom Achievement" button located in the top right corner.
A pop-up window will appear where you can select the recipient of the achievement and customize its details.
Customizing Achievement Details:
Achievement Title: Give your achievement a descriptive and memorable name.
Description: Provide a brief explanation of what the achievement recognizes.
Color: Choose a color that visually represents the achievement.
Icon: Select an icon that aligns with the achievement's theme.
XP Reward: Determine the number of experience points (XP) to be awarded for earning this achievement.
Assigning the Achievement:
Select the contributor who deserves the custom achievement from the dropdown list.
Click the "Save" button to create and assign the achievement.
Custom branded SVGs (Premium plan feature)
Specify your SVG URL: In the "Assign Custom Achievement" or "Custom Challenges" configuration to use as a badge
Advanced Features
Using Custom Achievements for Specific Goals:
Bug Fixing: Reward contributors who identify and fix critical bugs with a "Bug Buster Badge" (icon: fa-bug, color: #e74c3c).
Code Design: Recognize contributors who demonstrate exceptional code design skills with a "Code Architect Award" (icon: fa-code, color: #3498db).
Documentation: Acknowledge contributors who create and maintain high-quality documentation with a "Documentation Guru Badge" (icon: fa-book, color: #2ecc71).
Community Building: Honor individuals who foster a positive and engaging community with a "Community Catalyst Award" (icon: fa-users, color: #f39c12).
Leveraging Custom Achievements for Project Impact:
Feature Development: Celebrate contributors who introduce innovative features with a "Feature Maestro Medal" (icon: fa-magic, color: #9b59b6).
Testing: Award contributors who create comprehensive test suites with a "Testing Trailblazer Trophy" (icon: fa-flask, color: #1abc9c).
Accessibility: Recognize contributors who prioritize accessibility with an "Accessibility Advocate Accolade" (icon: fa-globe, color: #d35400).
Localization: Highlight contributors who translate the project into multiple languages with a "Localization Luminary Laurel" (icon: fa-language, color: #34495e).
Using Custom Achievements for Project Security and Performance:
Security: Recognize contributors who address security vulnerabilities with a "Security Sentinel Shield" (icon: fa-shield-alt, color: #c0392b).
Performance: Acknowledge contributors who optimize project performance with a "Performance Pioneer Pin" (icon: fa-bolt, color: #27ae60).
UI/UX: Reward contributors who enhance the user interface and experience with a "UI/UX Virtuoso Victory" (icon: fa-search, color: #f39c12).
DevOps: Recognize contributors who streamline development processes with a "DevOps Dynamo Distinction" (icon: fa-cogs, color: #3498db).
Common Issues and Troubleshooting
Lack of Clarity: Ensure the achievement title and description are clear and understandable for all contributors.
Irrelevant XP Rewards: Assign XP rewards that are relevant to the achievement's value and impact.
Overuse: Avoid creating too many custom achievements, as it can dilute their impact.
Best Practices and Use Cases
For Open Source Maintainers: Use custom achievements to recognize contributors who go above and beyond in areas like documentation, community building, or security.
For Project Managers: Create custom achievements to incentivize specific tasks or milestones, like closing critical bugs or completing feature development.
For HR Teams: Use custom achievements to recognize individual contributions and foster a positive and engaging work environment.
Recommendations
XP Rewards: Consider the effort and impact of the achievement when assigning XP rewards.
Clarity and Visibility: Ensure that the achievement titles and descriptions are clear and easy to understand.
Fair Usage: Use custom achievements sparingly and strategically to maintain their value and impact.
By utilizing the "Custom Achievements" feature effectively, you can create a rewarding and motivating environment for your contributors, fostering a sense of accomplishment and encouraging continued engagement with your project.