The following content describes how a branching lifecycle workflow would look from branch creation to change deployment.
Foundry branches can be created in Pipeline Builder, Ontology Manager, Workshop, or directly in the Foundry Branching application. It is important to note that each branch is associated with a single Ontology.
In Pipeline Builder, Ontology Manager, and Workshop, you can create a new branch by selecting the branch selector dropdown located at the top bar and then selecting Create new branch. The branch selector will display the name of the active branch currently being viewed. If you are on the main branch, this field will display Main.
While viewing a branch other than Main, the branch taskbar will appear in the application. You can also initiate creating a new branch from here by selecting the branch selector and then selecting Create new branch.
Additionally, you can create a new branch from the Foundry Branching application by selecting the New button.
You can navigate through Foundry branches using Pipeline Builder, Ontology Manager, Workshop, or directly through the Foundry Branching application. Note that branches are associated with a single Ontology.
In Pipeline Builder, Ontology Manager, and Workshop, you can navigate to an existing branch by selecting the branch selector dropdown located at the top bar and selecting a branch. The branch selector will display the name of the active branch currently being viewed.
While viewing a branch other than Main, the branch taskbar will become visible in the application. From here, you can also navigate to an existing branch by selecting the branch selector and choosing your desired branch.
Additionally, you can find and navigate to an existing branch from the Branches tab of the Foundry Branching application.
When you are happy with the state of your branch, you can create a proposal to have the changes reviewed. You can create a proposal by selecting Propose changes within the branch taskbar to open the Create proposal window. Enter a proposal name and a proposal description and select Create proposal.
Once a proposal is created, you will need to add reviewers for the proposal. You can do this in the branch taskbar in either the resources selector or the deploy changes selector. Select Add and search for the desired user or group to add as a reviewer.
Reviewers can also be added from the Overview and Resource and approvals tabs of the proposal in the Foundry Branching application.
Reviewers can navigate to a proposal in the branch taskbar by selecting either:
Awaiting review status.Not deployable status.These will bring the reviewer to the proposal where they can review and approve the changes.
You can navigate to resource proposals from the Overview and Resource and approvals tabs of the proposal within the Foundry Branching application.
Once changes have been approved, you can deploy the changes to the main branch by selecting the Deploy to main option within the branch taskbar or from the Overview and Resource and approvals tabs of the proposal within the Foundry Branching application. This action deploys changes from the branch to the main branch.