At Tettra, we strive to build a product that is simple, smart, and connected. We want to help you use the tools you already rely on but use them in faster, more effective ways. The GitHub integration is a cornerstone of our connected philosphy. It's available on all plans and is included in the price of your Tettra subscription.
How to Enable the GitHub Integration
Log into your account and go to the dropdown in the top right. Within "Team Settings", go to "Integrations", and click the “Connect GitHub” button. This will take you to a GitHub page.
You'll then be able to pick which repositories Tettra can access. These permissions allow Tettra to search for issues and read the issue content; they don’t allow any access to code. (We also request write access to issues, so we can backlink to the Tettra page from the issue.)
After selecting your repository, you'll be redirected back to the integrations page. You can go back anytime to edit which repositories are connected (or uninstall completely, should you wish.)
Note that this is installed at the team level, so once the integration is enabled, everyone can use it. Only a GitHub admin may install the integration, (and this person must be a Tettra user or admin, ie not a guest or read-only user.)
How to Use the GitHub Integration
Within a Tettra page, type # and then begin typing the name of the GitHub issue you want to reference. We’ll search within GitHub (both titles and content,) to give you options for possible issues. Select the one you want.
When you, or someone on your team, looks at that page, they'll see the GitHub issue embedded. Clicking on it will take you to that issue within a new tab. The icon will be green if the issue is open and red if it's closed.
If you hover over the embedded issue, you’ll be able to see meta information like labels, timestamp, and the number of comments on the issue.
We automatically pull in the latest changes, so the embedded link will always be up-to-date!
How to Disconnect this Integration
If you'd like to disconnect the Tettra GitHub integration, you can do so from your Team Integrations page. Navigate to the page, select "edit" next to GitHub, then disconnect the integration from within GitHub. Please note that you'll also need to be an admin in GitHub to make this sort of change.
Why We Built this Integration
In case you're curious, we built this to make life easier for all the product and engineering teams that rely on Tettra. So much of an engineering team’s work takes place in GitHub: it's where we build the product, keep track of bugs, and log new features we want to build.
We’ve found that we were referencing issues in GitHub all the time in our planning documents; they came up whenever we wanted to give context about a project. (And goodness knows, context sure is important!) It was annoying to go to GitHub, find the issue, then link to it. Plus, that link didn’t have any of the metadata, (like the status of an issue.)
Instead, we wanted to have all the right info in one place without having to duplicate work. We wanted to be able to easily search and embed GitHub issues within Tettra pages. And so, we decided to solve this once and for all! Please let us know if you have feedback on this integration or on how you use it.