A baseline is an immutable object that represents a configuration (that
is, state) of a component at a specific point in time. Baselines are useful to initialize streams,
share changes, or revert a component to an earlier configuration.
A baseline consists of one or more change sets. Delivering or accepting a baseline effectively
delivers or accepts all the change sets in it. They are numbered sequentially when created and you
can give a name and description.
The components in a workspace or a stream include the current baseline ID and name that is shown
in the Team Artifacts view, Pending changes view, and the New Snapshot dialog box.
When a component includes change sets that are not part of the current baseline, an asterisk is
displayed next to the baseline ID. To see more information, move the cursor over the component.
However, for components in a hierarchy the asterisk is displayed when:
The component includes changes that are not part of the current baseline.
Any subcomponent includes changes that are not part of the current baseline. See, Figure 1.
Any subcomponent is at a baseline that is not part of the hierarchical baseline of the parent.
See, Figure 2.
The hierarchical baseline for the component includes child baselines but the child component is
not in the workspace. See, Figure 3.
Examples:Figure 1. Asterisk is displayed on subcomponent as it contains a
change that is not part of the current baseline. Also, on parent component as it includes a
subcomponent that is not at its baseline P1.Figure 2. Asterisk is displayed on parent component as it includes a subcomponent that is at a
baseline S2 that is not part of the hierarchical baseline P1.Figure 3. Asterisk is displayed on parent component as it includes a subcomponent that was removed
from the workspace.
A snapshot includes one baseline for each component in a workspace
or stream.
