I like using xrefs because Flare will update the reference for me if the first H1 in the referenced topic changes.
Code: Select all
<MadCap:xref href="admin_company.htm">Company Profile</MadCap:xref>
I use xrefs within a "Related Topics" block at the end of each topic as well as in-line references. These are easy to create since I just drag a file from Content Explorer onto my topic. Because I use in-line references to other docs and topics, there no need for a lengthy list at the end of the topic. I try to limit those references to topics the reader might be interested in. For example, they may have hit the current topic as a result of a search but it was a near miss.
What are your thoughts? Is there a user need you are trying to solve?