Links to comparison page cannot be used because of ... (3 dots) to … (1 tripple-dot) replacement by Asciidoc renderer
Problem
The Asciidoc renderer replaces ... by … even for links. For instance, a link to a GitLab comparison page between two tags, e.g.
https://example.gitlab.com/$projectPath/-/compare/0.1.4...0.2.1?from_project_id=537&straight=false[my link]
Will be replaced by the renderer to
https://example.gitlab.com/$projectPath/-/compare/0.1.4…0.2.1?from_project_id=537&straight=false[my link]
Notice the ... to … replacement.
This means, that by default the comparison page links are not useable from Asciidoc rendered in GitLab (e.g., to reference comparisons from software validation reports).
Quickfix
Escape the ..., e.g. \.... This will prevent the renderer from replacing the ....
Disclaimer
After creating the issue I noticed the cause and workaround of the problem. I'm also not sure whether the problem really is a GitLab problem, or even a general Asciidoc problem.
I decided to compile my information for others as reference, and leave the issue open for you to decide how to deal with it. For instance, you might allow for an alternative URL that understands the …. This would solve this problem, even if it is a general Asciidoc problem out of your control.