We’re glad to have you on Middleware and excited to be a part of your growth journey!
Our goal is to make your team productive vs being busy and in this doc we will talk about the quickest way to get started! We will also discuss about any permissions required, assumptions taken and if any optional process change is suggested.
You can find the integrations page from the side bar on the left.
Choose your Git provider from the choice of Github, Bitbucket or Gitlab
Permissions required
Organisation - We need this permission to list repositories for the particular organisation.
Repo - All the git providers we support(Github/Bitbucket/Gitlab) provide only a full repository access for private repos. However, we only use your token to read the following data:
Pull Requests(PR) - We only read and store the event timestamps, author details, titles and PR numbers for linking
PR Commits - We only read and store commit id, created at timestamp
PR Comments and activity - We only read and store counts, type of comment and event timestamps for analytics
Assumptions/Process change needed
There is no process change needed as long as your team uses Pull Requests to make changes to your repository. We do not track your code or any commits which do directly to the main branch.
Troubleshooting
While integrating with Github, You might see Grant option in front of your organisation.
Clicking on Grant might send it for the approval to the admin. Proceed after granting access to sync in your insights with Middleware!
Select repos to sync. Choose your org → Select repos → Save and Done!
Choosing repos for sync
3. Integrate JIRA 📈
Let us integrate JIRA. Naturally, the way to integrate any of your engineering tools is very similar on Middleware. If you followed through the Git integration above, JIRA will be a breeze for you.
Goal: Get to your first insight 🚀
Step by Step guide 🤝
1. Login into your workspace 🔓
2. Integrate Git 🔗
3. Integrate JIRA 📈