Create and manage pull requests
This page describes how to create, review, and merge pull requests in Codeflow.
Create pull request
A pull request requests review and approval before merging changes from a work branch into a base branch. To create a pull request, select the base branch to merge into, the work branch that contains changes, and reviewers who will review and approve the changes.
Depending on the repository approval rule, conditions such as approval from specified reviewers must be met before merging.
- Go to the KakaoCloud console > Developer Tools > Codeflow.
- From the Repository menu, select the repository where you want to create a pull request, then go to the Pull requests tab.
- In the pull request list, click [Create pull request].
- Enter the required information and click [Create].
- On the details page, check the created pull request.
View pull request list
In Codeflow, you can focus on pull requests in a specific repository or view work across all repositories you have permission for in one place. Use one of the following two methods depending on your purpose.
View by repository
Use this when you want to understand the overall code review and merge status of a specific project. You can view pull requests from the Pull requests tab on the repository details page. In the list, you can check the pull request number, name, base branch, work branch, creator, and creation time.
- The creator can cancel, merge, or delete a pull request from the [⋮] button in the list.
- Reviewers can go to the details page to approve, reject, or cancel review of a pull request.
View all pull requests
Use this when you want to quickly check work that needs to be handled now, such as pull requests you created or need to review across multiple projects. You can view them from the Pull requests menu on the left. This is for integrated search. Related controls, such as cancel, merge, delete, approve, reject, and cancel review, are performed on the details page.
Pull request status
Pull request progress is categorized as Status, and reviewer review results are categorized as Approval status.
| Status | Approval status | Description |
|---|---|---|
OPEN | Pending | Approval or review is in progress |
OPEN | Approved | Approval conditions have been met |
CLOSED | Merged | The pull request was approved and merged into the base branch |
CLOSED | Canceled | The pull request was canceled |
CLOSED | Rejected | The pull request was not approved and was rejected |
View pull request details
Select an item from the pull request list to go to the details page. On the details page, you can check the pull request's basic information, activities, commits, and changed files.
Details
In Details on the details page, you can check the pull request name, branches, creator, reviewers, status, approval rule, and approval status. The creator can cancel, merge, or delete the pull request, and reviewers can approve, reject, or cancel review.
Depending on the repository approval rule, conditions such as approval from specified reviewers must be met before the creator can merge.
Activities
You can write comments with opinions or review details about the pull request, and check major change history such as status changes and reviewer changes in chronological order.
Commits
In the commit list, you can check commit message, commit ID, author, and commit time.
Changed files
In the changed file list, you can check the diff for each file and the number of added and deleted lines. Changes are provided in Unified view or Split view.
- You can check or copy the file path.
- Click file view to go to the file details page in the Code tab.
- You can write comments by code line. If you are not included as a reviewer, you are automatically added as a reviewer. The creator is excluded.
Diff files larger than 1 MB have limited view modes. Use a local Git client to check the changes.
Cancel, merge, or delete pull request
The creator can cancel, merge, or delete a pull request from the [⋮] button in the pull request list or the button at the upper-left of the details page. When a pull request is canceled, the approval status changes to Canceled; when it is merged, it changes to Merged. Deleted pull requests are removed from the list.
Only the creator can cancel, merge, or delete a pull request.
- If a code conflict occurs, you must modify the code and resolve the conflict before merging.
- If there are no changed files, the pull request cannot be merged. Push a new commit to add changes, or cancel or delete the pull request.
Approve, reject, or cancel review
Reviewers can approve, reject, or cancel review of a pull request from the [⋮] button in the pull request list or the button at the upper-left of the details page. When a pull request is approved, the approval status changes to Approved; when rejected, it changes to Rejected. When review is canceled, the approval status changes back to Pending.
Only reviewers can approve, reject, or cancel review of a pull request.