Details
-
Suggestion
-
Resolution: Unresolved
-
Not Evaluated
-
None
-
None
-
None
Description
Solving ambiguous links in QDoc documentation currently requires a manual insertion of a user-defined target name for the \target command.
Allowing user-defined target names for the \target command poses a risk of the same target name(s) being used on different pages, which can lead to additional broken/ambiguous links in the long run.
Would it be possible to (automatically) generate unique link target IDs for different elements on the page? The \section element seems to be a commonly used link target (perhaps the only internal link target currently used?) , so as a first step it might be enough to generate the target IDs for the \section elements.
In some modular documentation/component content management systems the system generates the unique IDs for all the elements on a page when the page is saved. Some systems also include an additional "Generate IDs" function/button that the writer can use to generate the IDs.