Quickstart: Branches

Seamlessly work together on multiple tracking plan updates using branches

2 minute read

What are branches?

In Avo you can collaborate in real time on defining, expanding and implementing your tracking plan. But you might want to try out some changes or make sure that a change is implemented before you change your tracking plan source of truth. To capture this work in progress you can use branches.

We highly recommend always creating a branch first before making changes to the tracking plan, no matter how small the changes are – in particular if the changes made require implementation. If changes are made directly on the main branch, then you risk someone else creating a branch that include your incomplete changes, which will very likely lead to conflicts in the future.

Creating a branch

To create a new branch, first make sure you are on the main branch. Then click the icon with the plus sign next to where it says main.

Review branch changes

To compare the changes drafted on a branch to the source of truth on the main branch, go click the review changes button located under your branch name. There you can see which events or properties were added, deleted or updated.

How should branches be structured?

We recommend setting up branches that have isolated changes that can be opened, implemented and merged within a few days. Typically there's a one to one mapping between Avo branches and git branches.

Like in git, we recommend against creating big branches with a backlog of events and properties to be implemented. We'd rather recommend splitting them in to manageable chunks that will be implemented together in a single git branch.

Deleting a branch

Go to the branch review screen (“View Changes” in the Sidebar), click the tripple-dot in the top right corner. From there you can choose to delete the branch:

Opening a branch

What's next?