Organization Settings

Organization Settings

In the Korbit console, you can customize how Korbit will interact with your pull requests and your team. Once you have completed the Getting Started Guide you can click here (opens in a new tab) to go to your organization settings.

Review Schedule

Korbit can be configured to comment on pull requests automatically and/or when a developer asks for input.

By default, Korbit will not comment on draft PRs.

You can always trigger a review from Korbit by commenting /korbit-review on your pull request.

This setting applies to all repositories in your organization.

Automatic PR Descriptions

As a Korbit admin, you can enable or disable Korbit’s automatic pull request descriptions feature. When enabled, Korbit will automatically append a description of the changes to your existing pull request description whenever a Korbit review is triggered.

Maximum Comments

Korbit will prioritize the most important issues it finds but you can set an upper limit of comments per review.

This is useful when Korbit analyzes larger PRs and sometimes finds a lot issues.

Issue Categories

As a Korbit admin, you can control which issue categories will be surfaced during a review and set a minimum severity for each category. Issues are classified as follows:

Functionality

Issues related to feature functionality, edge case handling, user interaction outcomes, and proper integration of functions, classes, and algorithms.

Security

Issues intended to protect your software against unauthorized access, data breaches, and other forms of exploitation.

Performance

Issues related to how efficiently (with respect to memory and processor time) your code responds to user actions, utilizes resources, and processes data.

Database Operations

Suggestions related to accessing, changing or adding to information in your database(s).

Asynchronous Processing

Suggestions to avoid potential race conditions, encourage performance optimization for asynchronous processes, etc.

Error Handling

Suggestions for detecting, responding to, and resolving exceptions or errors that occur while an application is running, plus how those errors are explained to users.

Naming

Clarity and consistency of the names of variables, functions, classes, and files your team uses in your code.

Logging

Suggestions to encourage writing clear, meaningful log messages, and ensuring that logs contain relevant information without exposing sensitive data.

Tests

Issues relating to unit tests, integration tests, system tests and acceptance tests.

Design Patterns

Any issues or best practices related to the consistency and clarity of the choice and application of creational, structural and behavioural design patterns in your code.

Systems and Environment

Issues related to the setup and configuration of your environments

Documentation

Clarity and breadth of inline comments, API documentation, README files, etc in your code.

Readability and Maintainability

Related to the structure of your code and suggestions on how to break it up or simplify it to facilitate re-use, clarity and easier maintenance.

Third-party Libraries

Issues related to the use of third party libraries, the way they are imported and kept up to date in your code.

Repositories

In order for Korbit to comment on your PRs, you must grant access to the Korbit application in GitHub or BitBucket.

In the Repositories section of the Korbit console, you can see which workspaces and repositories have been granted access.

If you want to add additional repositories or remove access for one or more repositories, click through to GitHub or BitBucket to make the change.

Manage Team

In this section, an Admin can invite other team members to the Korbit console. An Admin can also remove team members from the console.

Any team member with access to the repository can ask Korbit for a review. It is not necessary for the team member to have console access to use Korbit via GitHub or BitBucket.

Only team members who initiate a Korbit review in a billing period are considered as billable seats. You are not charged for Admins and other team members who do not make PRs.