Links: Internal and External

A link is a connection between two folders, two items, or a folder and an item on the same server, or on two different servers (called External Links). You can view links by using the Link tab in the lower pane of the StarTeam Cross-Platform Client.Creating links can be quite useful. For example, linking a file to a change request allows you to mark it as fixed when you check in the edited file. By linking files to the requirements document that the files fulfill, you can easily refer to or update the document.

In addition, linking files to change requests enables you to mark the change requests as fixed when you check in the corresponding files. In turn, if you link each set of files to the requirements document that the files fulfill, you can easily refer to or update the document.

A link does not provide a connection to a single share (or reference), but to all related shares and branches of an item. Links are not affected by any item operations, such as branching, moving, sharing, and so on. By default, a link connects the tip revisions of the linked pair.

Links can either be pinned or floating:

Pinned
You can lock the link to the tip revision. The context menu in the link tab enables you to pin links to the source or target items or both.
Floating
You allow the link source or target to change from tip revision to tip revision as new revisions are created. The context menu in the link tab enables you to float links to the source or target items or both.

Links, as with all other items, have context menus in their tabbed panes which allow you access to more information about the item.