Documentation

Welcome to Pull-up!

Thanks for choosing Pull-up to help you improve your code. This guide will walk you through setting up your account using either GitHub or Bitbucket.

If you've already set up your account, skip ahead to configuration.

GitHub Account Creation

If you haven't already signed in, go to the login page here. Once logged in, you'll be redirected to a landing page with a tab for each of your GitHub organizations, like this:

Select the tab for the organization you'd like analyzed. Click "Connect to GitHub" to get started with analysis. You'll be sent to a GitHub authorization page:

From this page, you can dictate which repositories Pull-up has access to. If you select "All Repositories,", Pull-up will be able to acces new repositories. Otherwise, you'll have to manually add them. After clicking "install," you'll be ready the next step: configuration.

Even though you've given Pull-up access to your GitHub repositories, you may still have some configuration to do.

Bitbucket Account Creation

If you haven't already signed in, go to the login page here. Once logged in, you'll be redirected to a landing page with a tab for each of your Bitbucket organizations.

Unfortunately, if you're not an admin for your organization, you'll have to reach out to one in order to authorize Pull-up.

Otherwise, your landing page should look something like this:

Select the tab for the organization you'd like analyzed. Click "Connect to Bitbucket" to get started with analysis. You'll be sent to a Bitbucket authorization page:

Once you click "Grant access," you're ready for the next step: configuration.

You'll probably still have some configuration to do to turn on analysis for C# repositories.

Configuring Analysis

You've logged in. You've authorized Pull-up to access your organization's repositories through GitHub or Bitbucket. Next, we're going to walk through configuring analysis for a repository.

Any repositories that are detected to be C# should automatically start analyzing. You'll know that they're analyzing based on what's in the "Analyzed?" column.

Whether the language is detected as C# or not, you can click "Turn On" to enable analysis on any repository to start analysis. Once analysis is turned on, you'll be able to configure the repository settings by clicking on "Configure."

This page allows you to turn analysis on/off, but perhaps more importantly, it allows you to configure the solution file Pull-up will use to build your project. If you leave this field blank, Pull-up will only analyze your repository based on solution files in the project root. If your project root doesn't contain a solution file, Pull-up will traverse your entire project and analyze any solution file it finds.

If you want to specify a solution file, enter its relative path, e.g. Directory\MySolution.sln. For multiple solution files, separate them by semi-colons, e.g. Directory1\MySolution1.sln;Directory2\MySolution2.sln;Directory3\MySolution3.sln

Troubleshooting

You've granted Pull-up access to read your pull requests, but maybe you aren't seeing any analysis reports yet. Or maybe you're seeing analysis reports, but they're failing and you don't know why. We're here to help! You can browse through some common issues below, or reach out to us at support@pullupcode.com.

None of my organizations show up after authorizing Pull-up with [GitHub or Bitbucket].

The most common cause of this has to do with the asynchronous process of loading repositories from GitHub and Bitbucket. You should be able to log out and log back in to see your repositories. If not, let us know.

Pull-up is missing repositories or pull requests from my team's homepage

If you're a GitHub user, it's possible Pull-up only has access to certain repositories. To check this, go to your organization's settings, select "Applications," and click "Configure" on Pull-up. There is a subheading titled, "Repository Access," which allows you to set which repositories Pull-up can access.

Otherwise, you can try to re-sync your data with Pull-up. This process will add any new repositories to Pull-up (as long as we have access), and detect all of the related pull requests. To do this, start by going to the homepage and logging in.

  1. Select the correct organization's tab, and click "Team overview:"
  2. Toward the bottom of the page, in the panel labelled "Organization Settings," select "Configure:"
  3. From this page, select the "Troubleshoot" tab. Then, click on the button that says "Synchronize Data:"

At this point, Pull-up will scan your organization's repository data for previously undetected repositories and pull requests. New repositories that are detected as being C# will automatically begin analyzing. Otherwise, you may need to configure them in order to begin analysis.

Wait... none of these worked for me. What now?

It's possible we just haven't seen a solution like yours before! Let us know, and we'll do our best to accomodate your project automatically: support@pullupcode.com.