TFS Integration Tools – Why does guidance state that TFS supports directory level branching? Is this an error?

We received the following question

On the Branching section of the "TFS Integration Platform - Subversion Migration Guidance" document, it is stated "Perforce and Clear case, for example, are based on file level branching, whereas TFS is based on directory level branching". I am able to branch a single file in TFS, so is this an error in the documentation or do they mean something else?

Response

We are busy updating the readiness package and associated documentation to clarify the statement. File branching is supported in Team Foundation Server, but the best practice is to branch at the folder level, or better yet, at the branch level. Clearcase has a different model that results in individual file branching, or what we would call sparse branching. It is critical to understand Team Foundation Server branching (see https://tfsbranchingguideiii.codeplex.com/ for more information) and the guidance in order to formulate the best migration plan.

What to avoid …

Avoid complex branching structures, such as the following:
DSC00288