Branch PI markers in maps allow you to specify inclusion of the same topic in more than one place in the output (see §9.6.3 Reusing the same topics with different conditions). How do you specify where a cross reference to a duplicated topic should go? DITA2Go applies two rules, in the following order:
<?dtall xrefbranch="branchname" ?>
A cross-reference branch PI applies only to the very next cross reference.
If neither of these rules applies, the cross reference goes to the first instance of the topic.
Suppose in common_intro.dita you want to reference an introduction that occurs in each branch. You would insert a cross-reference branch PI in the referencing topic, just before each cross reference. For example:
<p>The following products are described here: <ul> <?dtall xrefbranch="productA" ?> <li><xref href="product_intro.dita" /></li> <?dtall xrefbranch="productB" ?> <li><xref href="product_intro.dita" /></li> </ul> </p>
The references are both to the same file; the PIs sort out which instance of the file to target. So if the file referenced has conditions applied to <ph> elements in its title to yield different resulting titles, you get the correct title for each in the list items.