How to Configure Your devActivity General Organization Settings
devActivity's General Organization Settings provide comprehensive controls to customize your developer analytics experience. This guide will walk you through configuring essential integrations, reporting preferences, and feature toggles to optimize devActivity for your team.
Manage GitHub App Integration and PR Comments
Navigate to the 'GitHub App' section. Click the 'Manage GitHub app' button to adjust repository permissions or install the app for other organizations. If your data seems outdated, click 'Sync now →' to refresh it. To enable automated feedback, toggle the 'Enable PR Comments' switch to ON. This will allow the devActivity bot to post comments on merged Pull Requests, summarizing key metrics like Cycle Time, Coding Time, Pickup Time, and Review Time directly within GitHub.
Connect devActivity to Slack
In the 'Slack' section, click the 'Manage app' button. This will guide you through installing the devActivity app from the Slack Marketplace. Once connected, you'll receive alerts, notifications, scheduled reports, and peer recognition requests directly in your Slack workspace.
Configure Peer Feedback (Recognition Awards)
Under 'Peer Feedback (Recognition Awards)', use the dropdown menu (currently showing 'Disabled') to set reminders for submitting Recognition Awards. You can choose a monthly or weekly frequency, or keep it disabled. This feature encourages team members to acknowledge colleagues' achievements with specific awards and comments.
Set Your Organization's Timezone
Go to the 'Timezone' section. From the dropdown menu (defaulting to 'UTC (+00:00)'), select the appropriate timezone for your organization. All generated reports and analytics within devActivity will use this timezone for consistent and accurate data presentation.
Define Your Team's Work Schedule
In the 'Work Schedule' section, select the working days for your team (e.g., 'Mon', 'Tue', 'Wed', 'Thu', 'Fri'). Then, specify the 'Start Time' (e.g., '10:00') and 'End Time' (e.g., '18:00') for your workday. This schedule is vital for accurate metric calculation and alert generation, ensuring devActivity's insights reflect your team's actual working hours.
Activate Additional Analytics Reports
Locate the 'Additional Analytics (recommended for Open Source Projects)' section. Toggle the switches for 'Contributors' and 'Discussions' to ON to enable supplementary reports. These provide deeper insights into contributor activity and discussions, particularly useful for open-source projects, and are enabled by default for Open Source plans.
Delete Your devActivity Workspace and Account
While not directly visible in the main settings interface, devActivity provides an option to delete your organization's workspace and associated account. This administrative action typically involves navigating to a dedicated account management area. After deleting your devActivity workspace, you may then proceed to delete the associated GitHub App integration from your GitHub account settings.
