GitLab

Unblocked exists to answer questions about your application, so it leverages your codebase as a primary source for answering the questions you and your team ask. When you connect Unblocked with your GitLab group, you enable a critical data source for answers. However, you’ll also get a few extra, first-class features:

1. Unblocked refreshes your team’s data index as you make changes to your codebase. This means that answers to questions will reflect the latest updates to your codebase, while also taking into account your code’s history.
2. Any relevant merge requests will also be referenced throughout Unblocked alongside the discussions you or your teammates have with Unblocked. As your team works on parts of your codebase, Unblocked provides notifications for quick access to merge requests discussions that people are participating in. This is specifically something you’ll notice in the Mac app or in the IDE extensions.

​

Connect your organization and repositories

​

Sign in to Unblocked

Whether you sign in with GitLab credentials, another code repository, or your SSO provider, you first need to authenticate to Unblocked.

If you have an existing Unblocked account, you’ll need to select Data Sources in the sidebar, then GitLab once you’ve logged in. Otherwise, you’ll be immediately prompted to authorize the Unblocked app.

​

Authorize the Unblocked app

If you aren’t logged into GitLab, you’ll be prompted to do so.

Once you’re authenticated to GitLab, you’ll be asked to grant access to Unblocked. This access will allow Unblocked to read the GitLab groups you are a part of as well as check for repositories in those groups, but it won’t begin indexing those repositories yet.

​

Connect your repositories

Once you’ve given access to your GitLab account, Unblocked still needs to know which account’s or group’s repositories you want it to answer questions about. After authorizing access to GitLab, you’ll be redirected back to Unblocked, where you’ll be prompted to select the group or account you want to use with Unblocked.

While you can install Unblocked on any GitHub account or organization, Unblocked works best with your work organization and repositories.

​

Generating a model for answering questions

Unblocked is able to answer questions for the repositories that it has ingested into its model. After giving Unblocked initial access to your account or group, you’ll choose which repositories it should ingest. You can also select whether all new repositories should be automatically ingested into your Unblocked model.

Once you select the repositories you want to ask questions about, click Save and Continue, and Unblocked will get to work.

While it is certainly possible to use Unblocked without incorporating any further data sources, we strongly encourage you to include as many other systems in which you have documented or even discussed your applications.