Skip to main content
The GitHub integration lets you pull documentation from your repositories into DevUps learning paths. Paste a repository or file URL and DevUps detects markdown files automatically — or browse your repos directly from the Add Resource form to pick specific files.

​
Connect GitHub

1

Open Settings

Go to Settings → Integrations in your team workspace.
2

Connect GitHub

Click Connect GitHub on the GitHub card. A popup opens and redirects you to GitHub’s authorization page.
3

Authorize access

Review the requested permissions and click Authorize. The popup closes and the GitHub card updates to show a Connected badge with your GitHub account name.
The connection is per team. Each team workspace authorizes GitHub separately. If you belong to multiple teams, you’ll need to connect GitHub for each one individually.

​
Import GitHub content

Once connected, you have two ways to import GitHub files into a learning path.

​
Paste a URL

1

Copy a GitHub URL

Copy the URL of a GitHub repository or a specific markdown file from your browser.
2

Paste into the resource form

In the Add Resource form on your learning path, paste the URL into the URL field. DevUps detects it as a GitHub URL and fills in the Title field.
3

Review detected markdown files

If the URL points to a repository, DevUps scans for markdown files (.md, .mdx, .markdown) including README.md and any documentation files at the root level. A checklist of detected files appears below the form. All files are selected by default — uncheck any you don’t want to include.
4

Add the resources

Click Add Resource (or Add N Resources if multiple files are selected). Each markdown file becomes a separate resource item in the path, linked to its GitHub URL.

​
Browse your repositories

1

Open the Browse dropdown

In the Add Resource form, click the Browse button and select GitHub from the dropdown. The Browse GitHub modal opens.
2

Select a repository

The left panel lists your repositories. Click a repository to open its file tree in the right panel.
3

Navigate and select files

Browse folders by clicking them. Markdown files are highlighted and pre-selected. You can check or uncheck individual files, or use Select all markdown to toggle all markdown files in the current folder. Selections persist as you navigate between folders.
4

Import

Click Import. Each selected file is added to the learning path as a separate resource item, with its path and repository name as the description.
The modal shows repositories you have access to via the connected GitHub account, including private repositories. Markdown files are highlighted with an MD badge to make them easy to spot.

​
What gets imported

Each markdown file becomes a resource item linked to the file’s GitHub URL. The resource title is the filename with the extension removed (for example, CONTRIBUTING.md becomes CONTRIBUTING). The description includes the repository name and the file path within the repo.

​
Disconnect GitHub

Go to Settings → Integrations, find the GitHub card, and click Disconnect. Confirm the action in the dialog that appears.
Disconnecting removes the connection to your GitHub account. You can reconnect at any time, but you’ll need to authorize access again. Resources already imported into your learning paths are not deleted.
To switch to a different GitHub account, click Edit Access to re-run the OAuth flow.