If you don’t like leaving Github and want your project managers to stay informed on what you’re working on without having to log into a PM stack - now you can!

Enable Github in Assembla

In your Space, go to to Admin and select Integrations. Authorize your GitHub account by choosing Settings and then Authorize GitHub. Keep in mind that the GitHub integration will only appear if it has been paid for and enabled from the payer's account page.

If you would like to add repos from your organization, you will need Owner permissions. If you do not have that level of access, then you will only be able to see your own GitHub repos available for integration.

Troubleshooting Tip: Do you have Owner permission but still can't see repos from your organization? Try revoking GitHub permissions here and then reintegrate with Assembla.

Add a Github Repo to your Project

Open the green "+" button and select Add Github Repo. Choose the repo you want associated with your project from the dropdown menu that appears. This will automatically install the necessary webhooks on the GitHub side to ensure all events are delivered to Assembla in real-time.

Find and relate a GitHub Pull Request to a Ticket

While in Assembla, open a ticket in your project and find the GitHub button on the left of the screen. Click on it to find the pull requests you want to associate with this ticket. This allows project managers or dev leads to tag any pull requests to a ticket without relying on their devs.

Make a Commit in GitHub and see it in your Assembla ticket

With your GitHub repo ready for real-time sync, you can have all of your commits show up as comments in a ticket thread. The process is very simple, your devs just need to follow a particular protocol for “tagging” tickets in pull requests for them to show up:

Use re #ticket_number
i.e. re #52

OR

Use re #ACCOUNT_SUBDOMAIN/PROJECTNAME/TICKETNUMER
i.e. re #assembla-inc/assembla-design-team/43

We’re not done with just commits! One of the great features in Assembla is the ability to show all related merge requests from Git, SVN, Perforce, and now Github repos against the same ticket. The process is very simple, your devs just need to follow a particular protocol for “tagging” tickets in pull requests for them to show up: