Github helps your software team collaborate—providing versioning and access control and a suite of tools to help teams share and track their progress as they build and maintain software. Notion for Github gives teams insight into their process and helps team leaders understand their metrics over time. Track open issues, pull requests, resolved issues, and more directly in Notion.
Connecting to Github
To set up Notion for Github, you'll first need an existing account in Github. On the Github connector page—which can be found on the Integrations page—click Connect Github and enter your Github access token.
To generate a new Github token, log into your Github account and visit the Settings page and select Personal access tokens from the bottom of the menu. The only scope you'll need to set for the token is repo.
Please note, when you add a user's token from Github, each repository that user belongs to will be pulled into Notion. If you are only wanting to include certain repositories, we recommend creating a new team member in Github belonging just to those repositories and using that account to connect with Notion.
Ingredients are the building blocks of the KPIs and metrics you track with Notion. They can be added directly to a dashboard or combined in Recipes, custom formulas you can build with ingredients from any source.
To create an ingredient, choose a template from the left side panel on the Github for Notion page. You can name this ingredient whatever you choose.
Next, select the repository you want to track. You can use the same template as many times as you want, so you can easily track the same ingredient across multiple repositories.
Your ingredients will update automatically each day, giving you an accurate trend over time.
Mash-up your data
Once you have data being reported in Notion, try using our recipe builder to mix and match data from all of your tools.