Slab is founded by engineers — so one of the first integrations we built and use religiously is GitHub.
Why integrate with GitHub?
- Sync READMEs and .md files to Slab and organize and search them alongside your other documentation.
- Mention GitHub Issues and Pull Requests and view context such as open status, assignee etc in directly in Slab.
- Import GitHub wiki into Slab.
Enabling the GitHub integration
Note: You need to be a Slab site admin to enable this integration. In addition, you will need a GitHub organization account. Slab does not integrate with personal GitHub accounts.
Head to the admin dashboard by clicking Team Settings in the top left dropdown, then click on Integrations.
In the GitHub row, clicking on Integrate will take you through the OAuth flow to connect your GitHub account.
Sync or mirror GitHub markdown files
Engineering teams often store Getting Started and troubleshooting guides in GitHub as markdown files or READMEs.
However, this leads to silos between your GitHub content and the rest of your documentation.
With Slab you can mirror READMEs and .md files from GitHub, and organize and search them in the same way you would a document. You can even verify GitHub posts and add them to series!
When you try to edit it, we'll kick you back to GitHub so you can keep your version control on those mission critical docs.
Tip: You can even import READMEs from multiple different repositories.
Import from GitHub wiki
We make it easy to import your GitHub wiki and markdown files with a click.
In the top left dropdown, click Manage Team and then Import.
Note: You need to be a team admin to do this.
Link to issues and PRs
Paste in a link to an issue or a Pull Request and we'll magically unfurl it, showing you the status and assignee. Hovering over it will open more details.
Search GitHub from Slab
Our GitHub integration also allows you to access your GitHub repositories from within Slab.
Enabling the team search integration
Team admins can enable the team search integration in their admin integration settings. Admins can choose from all repositories in GitHub, or just select ones.