Foundry Branching is a Beta feature, and is in active development. Some functionality may change before this feature becomes generally available.
The scope of Foundry Branching is currently limited to Pipeline Builder, the Ontology, Workshop, and running Actions on a branch. Anything outside of this scope is not supported. For instance, if your Workshop module contains non-Workshop elements such as Quiver dashboards, these will not be modifiable on a branch.
Contact your Palantir representative to enable the Foundry Branching application on your enrollment. Before using Foundry Branching, familiarize yourself with the full scope of functionalities, especially what is not currently supported.
The Foundry Branching application enables you to maintain your organization’s branches. You can use the Foundry Branching application as a centralized hub for your branches, allowing you to create new branches, view branches and proposals, and approve and deploy proposals
The My items tab provides you an overview of your proposals and branches.
Under the My 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 My open branches section, you can view and access your open branches. Branches are a separate environment on which you can experiment and test ideas without affecting the Main
branch. You can also create a proposal for your branch, close your branch, or create a new Foundry branch directly from this section. Note that you can only close branches that do not have an open proposal.
At the bottom, you have access to shortcuts that navigate to your merged proposals, closed proposals, or closed branches, each of which will bring you to the Proposals tab.
The Branches tab landing page 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.
The following options are applicable:
You can filter branches by Status and Creator, and use the search bar to find branches by their names.
Selecting a branch will provide detailed information about that branch.
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 Preview status tab presents information about the preview status of the branch and its resources. Selecting a resource redirects you to the branched version of that resource. Once all resources are prepared for preview, the branch's preview status will be updated to Ready for preview. The possible branch resource statuses are:
Some Ontology resources may appear as pending even though they are ready for preview. We are working to resolve this issue.
The Proposals tab landing page enables you to view proposals you have permissions to access. You can filter these proposals by Status and Creator. The search bar lets you find proposals by their names. To close an open proposal, select the checkbox located to the left of the proposal and then select Close.
Selecting a proposal will provide detailed information about that proposal.
Changes to Workshop resources will be automatically approved if you have edit permissions on the resource. See Add reviewers to proposals for additional information.
Branch protection allows you to prevent unintentional changes directly to the Main
branch by requiring proposals and optional approvals before changes can be merged.
Branch protection is enabled by default for Ontology Manager resources. To merge changes to the Main
branch, you must create a proposal and set an approver. You can approve your own proposal if you have edit access on the object.
You can enable branch protection for Pipeline Builder resources in the branch settings menu.
Proposals for protected branches will require at least one approval to merge. Reviewers can select Review to view the changes in the proposal and approve or reject the proposal.
You can view the approval rules for a protected branch
Select Review to approve or reject the proposal. Reviewers can add a comment for the review, for example, their reasoning for approving or rejecting the changes.