General Organization Settings: Frequently Asked Questions
This section provides quick answers to common questions about managing your devActivity General Organization Settings, covering integrations, reporting, and feature configurations.
How do I manage devActivity's integration with my GitHub repositories?
In the General Settings, navigate to the 'GitHub App' section. Click the 'Manage GitHub app' button to adjust repository permissions, install the app for new organizations, or review existing integrations. You can also sync data if it appears outdated.
Can I enable automated comments on Pull Requests for performance metrics?
Yes, within the 'GitHub App' section of General Settings, toggle the 'Enable PR Comments' switch to ON. Once enabled, devActivity will automatically post a summary comment on merged Pull Requests, including key metrics like Cycle Time, Coding Time, Pickup Time, and Review Time.
How do I connect devActivity to Slack for team notifications and reports?
Go to the 'Slack' section in General Settings and click the 'Manage app' button. This will direct you to the Slack Marketplace to install the devActivity app. After installation, you can configure it to receive alerts, notifications, scheduled reports, and peer recognition requests directly in Slack.
What options are available for setting up Peer Feedback or Recognition Awards?
Under the 'Peer Feedback (Recognition Awards)' section, you can use the dropdown menu to configure reminders for submitting awards. Options typically include setting reminders on a monthly or weekly basis, or disabling the feature entirely. This allows team members to give structured recognition to colleagues.
How can I ensure devActivity reports use my organization's correct timezone?
In the 'Timezone' section of General Settings, select your organization's local timezone from the dropdown menu. This setting ensures that all generated reports, analytics, and time-based metrics are accurately presented according to your team's local time.
Where do I define my team's working days and hours for reporting?
You can define your team's work schedule in the 'Work Schedule' section of General Settings. Here, you can select the specific working days (e.g., Monday through Friday) and set the 'Start Time' and 'End Time' for the workday. This configuration is crucial for accurate metric calculations and alert generation.
Are there extra analytics reports available for open-source projects, and how do I enable them?
Yes, devActivity offers 'Additional Analytics' reports for 'Contributors' activity and 'Discussions', which are highly recommended for open-source projects. To enable them, go to the 'Additional Analytics' section in General Settings and toggle the respective switches for 'Contributors' and 'Discussions' to ON. These reports are enabled by default for Open Source plans.
How can I delete my organization's workspace from devActivity?
devActivity provides an option to delete your organization's workspace and associated account. While not directly on the General Settings page, this administrative function is typically found in a dedicated account or billing management area. After initiating the workspace deletion, you should also proceed to delete the associated devActivity GitHub App integration from your GitHub account settings.
