users-guide: Refactor handling of :base-ref: et al.

Closed Ben Gamari requested to merge wip/T23991 into master

Merge request reports