Global Branching application

The Global Branching application enables you to maintain your organization's branches. You can use the Global Branching application as a centralized hub for your branches and proposals, allowing you to create new branches, view branches and proposals, and approve and merge proposals.

Homepage

The homepage provides you with an overview of your proposals and branches.

Under the Your open proposals section, you can view and access your active proposals. Proposals serve as a mechanism for reviewing and approving changes made in a branch.

Under the Your open branches section, you can view and access your open branches. Branches are a separate environment where you can experiment and test ideas without affecting main. From this section, you can create a proposal, close an existing branch, or create a new global branch.

Open branches include both active and inactive branches.

At the bottom of the page, you have access to shortcuts that navigate to your merged proposals, closed proposals, or closed branches, each of which will bring you to the relevant tab.

Branching application overview page.

Branches

The Branches tab lets you view all branches that you have access to, and lists their name, status, creator, and creation date. You may also navigate to a proposal associated with a branch, or create a proposal for a branch directly from this list.

You can take the following actions:

  • New: Create a new branch.
  • Close: Close an open branch that does not have an open proposal.
  • Filter: Filter branches by Status and Creator, and use the search bar to find branches by their names.

To navigate to a specific branch page with more detailed information, select its corresponding row.

Global Branching app Branches tab.

Branch page

The branch Overview tab offers consolidated information about a branch and allows you to create a proposal or navigate to the associated existing proposal. Details include:

  • The branch's name and current status.
  • The resources that have undergone modifications.
  • High-level information about the branch, including the last time the branch was updated, branch creation date, branch creator, selected space, organizations, and ontology.
  • A comments section.

Global Branching app branch overview.

The branch Security tab allows branch owners and space administrators to manage role assignments. Refer to branch security for more information.

Global Branching app branch security.

Proposals

The Proposals tab lets you view proposals that you have permission to access and lists their name, status, creator, and creation date.

You can take the following actions:

  • Filter: Filter proposals by Status and Creator, and use the search bar to find proposals by their names.
  • Close: Close a proposal by selecting the checkbox located to the left of the proposal.

To navigate to a specific proposal page with more detailed information, select its corresponding row.

Global Branching app proposals tab.

Selecting a proposal will provide detailed information about that proposal.

Proposal page

The proposal Overview tab consolidates information about your proposal and allows you to track its status throughout the entire development process, from editing and testing to reviewing and merging. The central section of the Overview tab is a list of resources modified on the corresponding branch. For each resource in the list:

  • Manage reviewers according to the resource's approval policies. Refer to adding reviewers to proposals and resource protection and approval policies for more information.
  • Navigate to the resource's review experience.
  • View check statuses and resolve any failing checks. Review checks for a better understanding of this feature.
  • View the more options menu (...) for additional actions such as removing the resource from the branch.

You can also open your modified resources in Workflow Lineage and Data Lineage.

Global Branching app branch proposal overview.

The Merge history tab centralizes information about the proposal merge attempts and displays any errors encountered while merging a specific resource. This tab will only appear after the first merge attempt.

Global Branching app branch merge history.