Many places in the architecture guide use the following style for cross-references to other pages of the guide:

See @ref arch-cache for more information.

Doxygen turns this into a link that uses the title of the target page as the link text:

See Cache (Architecture Guide) for more information.

The parenthetical "(Architecture Guide)" is awkward.  We should update these links to provide better text.  For example using the following style in Doxygen:

See @ref arch-cache "Cache" for more information.

This will produce:

See Cache for more information.

It would be even easier if there is a way create a page that has one string that is displayed as its title and a different string that is displayed as link text.