do not use <link> element for example links

[dariavladykina]

Suggestion from Jana:
I found roughly 150 links reported as broken that are example URLs that cannot ever work and even aren't meant to. Can we suggest that authors do not use <link> or similar adoc equivalents, but rather use some other markup that changes the font to monospace, but doesn't create a (broken) link?

[dariavladykina]

These are links that illustrate some example and get formatted like a real URL. SI recognizes them as a real, broken link. We should educate our writers and make sure we find out whether asciidoc has some sort of automatism that turns anything http* into a real URL and whether this can be switched off.
https://ip_address_of_region_server/regionInfo?regionHint=REGION_NAME
For AsciiDoc, https://docs.asciidoctor.org/asciidoc/latest/macros/autolinks/ - here is both the feature and how to turn it off.

[tomschr]

It's all there.😉 For Docbook, use <uri>. That doesn't create a link, but is still displayed as monospace.

For ADoc you can have different options:

• Use a custom style [.uri]#URL#
• https://docs.asciidoctor.org/asciidoc/latest/macros/autolinks/#escaping-urls-and-email-addresses
• Double back ticks on each side of the URL

From my view, I think the first option would be the most flexible one. I'd recommend that.