Branches
********
Branches are a model to enable development without modifying data that is being used in production. They take inspiration from `version control software <https://git-scm.com/book/en/v2/Git-Branching-Branches-in-a-Nutshell>`_, where branching is a standard feature. The root or main branch, which has an ID of ``1``, can be considered the default dataset. Most models have a branch associated with them and the branch itself is persisted directly in the source.

.. Optionally, bframe can be configured to select non-root branches to be placed on top of the main branch. This enables a user simulate the outcome of making a modification without actually committing into the system of record. 

Diagram
=======
.. figure:: /_static/images/erd/branch_erd.svg
    :width: 1000px

Table description
=================

.. csv-table::
   :file: /_static/ex_tables/branch_col_desc.csv
   :delim: tab
   :class: bmodel-table
   :header-rows: 1