Upsource 2020.1 Help

Synchronizing your activities in GitHub projects

If GitHub synchronization has been enabled by the administrator, the following user activities will be synchronized between Github and Upsource:

  • Discussion comments posted on GitHub will be shown in Upsource and vice-versa.

  • Pull requests are recognized and can be created right from Upsource.

  • A branch review or merge review (depending on the project settings) will be automatically created on a new pull request.

  • The reviewer assigned on GitHub will be added to the review in Upsource (this only works one way).

  • A branch can be merged to the target branch and then deleted right from Upsource.

  • When the review is completed in Upsource, it is shown as approved on GitHub and vice-versa

A GitHub icon on the project home page means Upsource recognises you as a GitHub user:

github_synch_icon.png

If you are not recognized, click Login to GitHub:

login_to_github.png

Now you can merge branches, create and close pull requests from Upsource, and the comments you make in Upsource will be posted in GitHub as well.

Pull requests and merges

When a new branch is created along with a pull request in GitHub, Upsource automatically creates a code review for it. Depending on the options selected by the project administrator when creating or editing the project, Upsource will either create a Branch review or a Merge review.

  • Branch review displays a diff that lets you compare revisions within the branch.

  • Merge review diff lets you compare the branch with the target branch.

After reviewing and accepting the changes you can merge the branch without leaving Upsource:

git_sync_merge.png

If you decide to reject the pull request and not merge the branch, you can close the review — the pull request will then be closed in GitHub as well.

If the branch has conflicts with the base branch and cannot be merged automatically, a corresponding message will be displayed in place of the Merge button:

git_sync_conflict.png

After merging the branch, you can delete it right from Upsource:

git_sync_delete_branch.png

If the branch has been created without a pull request, you may create a pull request right from Upsource:

git_sync_pullrequest.png
  1. Go to the branch. You can open it from the Branches page or from the commit list by clicking the branch name (blue label).

  2. Click Create pull request.

  3. In the displayed dialog window, enter your pull request title and select the base branch.

  4. Click Create.

In addition to the pull request, a branch review will be created and the branch revisions included in it.

Last modified: 09 July 2020