Foundry Branching application

Foundry Branching limited functionality

Foundry Branching is in limited beta and is in active development. To use, contact Palantir Support to enable the Foundry Branching application on your enrollment.

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 your active proposals. To navigate to the branch proposal, select the proposal. To close an open proposal, select the checkbox located to the left of the proposal and then select the close button.

Similarly, in the My open branches section, you can view your open branches. To navigate to the branch overview, select the branch. To close an open branch, select the checkbox to the left of the branch and then select Close. Note that you can only close branches that have the Active status.

You also have the option to create a new branch from this section. To do so, select New, provide a name for your branch, and select the Ontology of the branch.

My items tab "Create Foundry branch" prompt.

Selecting View deployed proposals will bring you to the Proposals tab and automatically applies filters to only display the Deployed status and Created by your user.

Selecting View closed proposals will bring you to the Proposals tab and automatically applies filters to only display the Closed status and Created by your user.

Branches

The Branches tab landing page lets you view all branches that you have access to. You can filter branches by Status and Creator. Additionally, you can use the search bar to find branches by their names.

To close an open branch, select the checkbox located to the left of the branch and then select Close. Only branches that have the Active status can be closed.

Selecting a branch will provide detailed information about that branch.

The branch Overview tab offers consolidated information about a branch. Details include:

  • The branch's current status.
  • The resources that have undergone modifications such as pipelines, Ontology changes, and Workshop modules.
  • Metadata about the branch like resources, last updated, creation date, creator, selected space, and selected Ontology.

From here, you can also open a proposal for the branch and view or add comments regarding the branch.

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 and necessary builds and 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.

Proposals

The Proposals tab landing page enables you to view all 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.

The proposal Overview tab consolidates information about your proposal, including its current stage, resources requiring review, selected reviewers, and the associated branch. Here, you also have the ability to select reviewers and view or add comments pertaining to the proposal. To access this view, select a proposal from the Proposals tab landing page. Users or groups identified as reviewers can navigate to the review for each resource within the proposal.

The Resources and approvals tab centralizes information about the approval status of the branch and its resources. Selecting the resource will redirect you to the branched version of the resource. Here, you can view the selected reviewers, add reviewers to the proposal, and add comments. Users or groups identified as reviewers can navigate to the review for each resource in the proposal.

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.

The Deployment history tab centralizes information about the deployment of the resources of approved proposals for a branch.

  • Proposal stages: The first stage of a proposal is the Preparing stage. Select Ask for review to move your proposal to the In review stage. After all tasks have been reviewed and approved, the proposal moves to its final stage, Deploy proposal. From this point on, you can deploy your changes to the main branch using the same option.
  • View changes on your branch: Edits are displayed at the bottom of the Overview tab. Edits are categorized by author and by task, where a task corresponds to an Ontological resource. You can view the change, navigate to the resource, or discard that change. The history of changes is also accessible through the Changelog tab where the exact timings of changes are also displayed.
  • View and add reviewers: Assign specific colleagues to review your proposal. Reviewers will only get notified once the proposal has moved to the review stage.
  • View tasks that require attention: This section displays all rejected tasks in the review stage.