Setting up a Github Integration

If you use Github to manage your development workflow, you can set up a direct integration between ProdPad and Github, Zenhub and Zube.

The integration allows you to push ideas or individual user stories to Github, once you've completed fleshing out your product specs in ProdPad.

Getting the integration with Github set up is easy, and just requires you to follow these steps:

Part 1: Setting up the Github integration in ProdPad
Part 2: Pushing Ideas to Github
Part 3: Get your team on board


Part 1: Setting up the Github integration in ProdPad

To start, log in to ProdPad as an Admin, and head to the Integrations page. 

integrations.png

 

On the right-hand side of the page, select Github from the list in the available "Add an integration" options.

select_github.png

 

Name your integration and login to Github to complete the authorization process. 

You will now see a list of all of the projects* within your Github account that you can push ideas to. Select one of the projects by clicking on the name.

create_git.png

(*Note: the list will only show 200 projects. Please get in contact if you have more than 200 projects in Github)

Next select the project item for ideas and user stories (issue or comment) and map accordingly.

Select which fields from ProdPad you will be sending to each of the fields available to your Github project, as well as the status mapping that will reflect within ProdPad.

github.png

Click on 'Save Changes' to complete the mapping process.

Your Github integration is now ready to use!

Part 2: Pushing Ideas to Github

Now that you've got an active integration with Github set up, it's time to start pushing finished ideas from ProdPad to Github.

Head to your Ideas List, and pick an idea that's ready for development. In the Idea Canvas page, click on Push to Dev. This will open up a modal window where you can choose to push the Idea via the Github integration you've set up, or any of your other integrations.

Screen_Recording_2017-03-17_at_02.05_pm.gif

You should see the Github integration you just created. 

Once pushed, on the Idea Canvas now, there will be a link to the Pivotal Tracker ticket in the 'Links' section, and the ticket in Pivotal Tracker will link back to the ProdPad idea.

githublink.png

Part 3: Get your team on board

To make it easy for your team to use the same integration mappings, you can share your integration with your team.

In your Integrations list, toggle the 'Teamwide' on the integration page.

githubshare.png

Looking to add multiple projects?

If you wish to setup another project within Github, simply repeat the steps above. You may set up as many integrations as you like - and as long as they're the same account they will only count as one integration. 

Have more questions? Submit a request

Comments

Powered by Zendesk