qdoc does generate implicit anchors for all section titles. When there are multiple anchors for a link, local anchors are preferred.
This is convenient, but often leads to 'wrong' links being generated that are hard to detect. In particular, an innocent change that adds a section can break the links in otherwise unrelated places.
Let's explore ways to fix this.
- Should qdoc stop generating anchors for section titles?
- Should \externalpage, module names ... take precedence over local sections?
- Should there be a way to be explicit about external page, i.e. \l[EXTERNAL]
- Should qdoc warn about ambiguous links, forcing the user to make links explicit?