Foundry Branching application [Beta]

Foundry Branching availability

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

Branching application overview page.

My items

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.

Foundry Branching app landing page.

Branches

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:

  • New: Create a new branch.
  • Close: To close an open branch that does not have an open proposal.

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.

Foundry Branching app Branches tab.

  • 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 such as pipelines, Ontology changes, and Workshop modules.
    • High-level information about the branch such as number of resources changed, the last time the branch was updated, branch creation date, branch creator, selected Space, and selected Ontology.
    • A comments section.

Foundry Branching app branch overview.

  • 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:

    • Pending: Resources are not ready for preview across supported applications, and necessary builds or indexing have not commenced.
    • In progress: Resources are not ready for preview, but builds and indexing are underway.
    • Ready for preview: Resources have been successfully built and indexed, and are now ready for preview.
Known issue with Ontology resource status

Some Ontology resources may appear as pending even though they are ready for preview. We are working to resolve this issue.

Foundry Branching app branch preview status.

Proposals

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.

Foundry Branching app branch proposals tab.

Selecting a proposal will provide detailed information about that proposal.

  • The proposal Overview tab consolidates information about your proposal, including its current status, high-level details and associated branch. The overview lists all modified resources, with their corresponding status and reviewers, if applicable. Branch contributors have the ability to select reviewers for each resource, and reviewers can use the Review link to navigate to the corresponding resource. Refer to adding reviewers to proposals for more information. Any errors preventing a proposal merge will also be displayed here. Review merge checks for a better understanding of this feature. Finally, users can view or add comments pertaining to the proposal.
  • The Resources changed tab focuses on the resources section from the Overview tab.
  • The Branch preview status tab centralizes 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.

Foundry 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.

Foundry Branching app branch merge history.