Github
Set-up your Github connection on Dust
Limitations
GitHub synchronization is limited to issues, discussions, and top-level pull request comments.
In-code comments in pull requests, the actual source code, and other GitHub-specific data, such as commit history, are not synchronized unless you enable it.
Overview
Dust integrates with Github to bring your repository's Issues, Pull Requests, Discussions, and codebase- if enabled, into Dust, allowing for a streamlined data sharing and collaboration process.
Only Github Admins can set up this connection due to permission restrictions.
Setting up the Connection
Initial Connection Setup
- Access Control: Ensure you're a Dust Admin and have the necessary permissions on GitHub to establish connections.
- Navigate to Dust: Go to
Build
>Connections
> SelectGitHub
> Connect. - Authenticate: Click
Configure
and authenticate your GitHub account to grant Dust permission to access your GitHub data.
![Github redirect to install and configure Dust.](https://files.readme.io/32ff405-Untitled_29.png)
Github redirect to install and configure Dust.
![Github redirect to install and configure Dust.](https://files.readme.io/b17fd29-Untitled_30.png)
Github redirect to install and configure Dust.
- Select your repos: Give access to the repo you select from
Repository access
.
![Github redirect: select all repos.](https://files.readme.io/b05394d-Untitled_31.png)
Github redirect: select all repos.
![Github redirect: select granular repos you want to sync with your Dust workspace.](https://files.readme.io/182f0d0-Untitled_32.png)
Github redirect: select granular repos you want to sync with your Dust workspace.
- Enable Code sync: Optionally give access to your codebase by toggling
Code synchronization
.
![Dust modal to enable code synchronization.](https://files.readme.io/fa37dbd-Untitled_33.png)
Dust modal to enable code synchronization.
Permissions
Ensure the GitHub account used for the connection has ongoing access to the selected repositories. Changing permissions in GitHub may impact Dust’s ability to synchronize new data.
Updating the Connection and Managing Permissions
To modify permissions and which repositories or types of data are synchronized:
- Go to
Build
>Connections
. - Click
Manage
next to GitHub. - Click Add/Remove Data, Manage permissions, re-auth, and follow the steps above.
- Adjust your selections for repositories, then save your changes.
Data Synchronization
- Issues: Titles, descriptions, comments, and tags.
- Discussions: Discussion titles, initial posts, and comments.
- Pull Requests: Titles, descriptions, and top-level comments (in-code comments not included).
- Code Synchronization: Repository code from the default branch
Refresh and Sync Details
- Refresh Rate: Issues, Discussions and Pull-requests are maintained up to date in real-time. Code is synchronized every 4h.
Updated 11 days ago