General Organization Settings: Overview
The General Settings section on devActivity.com serves as the central hub for configuring your organization's core settings, integrations, and reporting preferences. Accessible via the 'Settings' top-level navigation and then the 'General' sub-level tab, this page empowers administrators to tailor devActivity to their specific needs.
Users benefit from a tailored devActivity experience through custom integrations, accurate reporting aligned with their team's working hours and timezone, and enhanced collaboration features like automated PR feedback and structured peer recognition. These settings optimize devActivity's utility, fostering better developer engagement and performance insights.
GitHub App Integration
This section allows administrators to manage devActivity's integration with their GitHub repositories. Use the 'Manage GitHub app' button to adjust repository permissions. You can also enable the 'Enable PR Comments' toggle to allow the devActivity bot to post a summary comment on Pull Requests upon merging. These comments include vital metrics such as Cycle Time, Coding Time, Pickup Time, and Review Time, providing immediate feedback within GitHub.
Slack Integration
Under the 'Slack' heading, configure your devActivity integration to receive alerts, notifications, scheduled reports, and peer recognition requests directly within Slack. Use the 'Manage app' button to install the devActivity app from the Slack Marketplace.
Peer Feedback (Recognition Awards)
The 'Peer Feedback (Recognition Awards)' section facilitates recognition within teams. You can set reminders for submitting Recognition Awards on a monthly or weekly basis, or disable this feature entirely. This feature allows team members to acknowledge colleagues' achievements with a comment.
Timezone Configuration
The 'Timezone' section allows your organization to specify its default timezone. All generated reports will utilize this setting for consistency and accuracy across all analytics and metrics.
Work Schedule Definition
Under 'Work Schedule', administrators can define the working days and hours for their team. This configuration, including selected days (e.g., Mon-Fri) and specific start/end times, is crucial for accurate alert generation and metric calculation within devActivity.
Additional Analytics
The 'Additional Analytics (recommended for Open Source Projects)' section provides options to enable supplementary reports for 'Contributors' activity and 'Discussions'. These reports offer deeper insights and are particularly beneficial for open-source projects, though valuable for commercial teams as well. They are enabled by default for Open Source plans.
Frequently Asked Questions
How do I manage devActivity's integration with my GitHub repositories?
Navigate to the 'GitHub App' section within General Settings and click the 'Manage GitHub app' button to adjust repository permissions and settings.
Can I enable automated comments on Pull Requests for performance metrics?
Yes, in the 'GitHub App' section, toggle the 'Enable PR Comments' switch to ON. devActivity will then post comments with metrics like Cycle Time and Coding Time on merged PRs.
How do I connect devActivity to Slack for team notifications and reports?
Under the 'Slack' section, click the 'Manage app' button to install the devActivity app from the Slack Marketplace and configure your integration.
What options are available for setting up Peer Feedback or Recognition Awards?
In the 'Peer Feedback (Recognition Awards)' section, use the dropdown to set reminders for submitting awards on a monthly or weekly basis, or choose to disable the feature.
How can I ensure devActivity reports use my organization's correct timezone?
Select your organization's appropriate timezone from the dropdown menu in the 'Timezone' section. All reports will then reflect this setting.
Where do I define my team's working days and hours for reporting?
In the 'Work Schedule' section, you can select the working days (e.g., Mon-Fri) and specify the 'Start Time' and 'End Time' for your team's workday. This ensures accurate metric calculation.
