Update xrefs that are broken in satellite d/s builds

[aneta-petrova]

What changes are you introducing?

Adding labels to a few xref cross-links.

Why are you introducing these changes? (Explanation, links to references, issues, etc.)

https://issues.redhat.com/browse/SAT-31298 reports a few xrefs that appear broken in Satellite builds. Satellite d/s docs tooling doesn't support multiple xrefs included on a single line, unless their labels are explicitly defined.

Anything else to add? (Considerations, potential downsides, alternative solutions you have explored, etc.)

Another solution would be to include each xref on a separate line, for example as bullet point lists. But adding the label should work too (example: 9.4 Setting the global out-of-sync interval).

Checklists

• I am okay with my commits getting squashed when you merge this PR.
• I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

• Foreman 3.14/Katello 4.16
• Foreman 3.13/Katello 4.15 (EL9 only)
• Foreman 3.12/Katello 4.14 (Satellite 6.16)
• Foreman 3.11/Katello 4.13 (orcharhino 6.11 on EL8 only; orcharhino 7.0 on EL8+EL9)
• Foreman 3.10/Katello 4.12
• Foreman 3.9/Katello 4.11 (Satellite 6.15; orcharhino 6.8/6.9/6.10)
• Foreman 3.8/Katello 4.10
• Foreman 3.7/Katello 4.9 (Satellite 6.14)
• We do not accept PRs for Foreman older than 3.7.

[github-actions]

The PR preview for bb639c0 is available at theforeman-foreman-documentation-preview-pr-3692.surge.sh

The following output files are affected by this PR:

• Configuring_User_Authentication/index-foreman-deb.html
• Configuring_User_Authentication/index-foreman-el.html
• Configuring_User_Authentication/index-katello.html
• Configuring_User_Authentication/index-orcharhino.html
• Configuring_User_Authentication/index-satellite.html

show diff

show diff as HTML

[maximiliankolb]

This looks like an issue with downstream docs frameworks. As far as I can tell, it previously affected two xrefs in a single line. So far, the solution was always to use bullet points (one per link).

I like this much better than adding titles to xrefs. Would you mind investigating this?

[aneta-petrova]

This looks like an issue with downstream docs frameworks. As far as I can tell, it previously affected two xrefs in a single line. So far, the solution was always to use bullet points (one per link).

I like this much better than adding titles to xrefs. Would you mind investigating this?

Sure, I can change all of these to bullet points. But first I'd like to know why you prefer bulleted lists :) I'm not saying no, it's just that when I compared the two options, bullet points seemed to make the text longer and used up a lot more words, which is why I decided to go with the labels. I don't have a strong preference myself but would like to understand your point of view better. @maximiliankolb