Open mmuehlfeldRH opened 1 year ago
If nmcli
is a command name, shouldn't it be in backticks?
This would not raise an alert:
Configure the WireGuard server by using xref:proc_configuring-a-wireguard-by-using-nmcli_assembly_setting-up-a-wireguard-vpn[`nmcli`]
In normal text yes, but we don't use markups in titles or link descriptions because the rendering looks strange.
I found an example on the Customer Portal where markups are used in an xref: It doesn't look like one single link with the markups.
I agree. According to IBM Style, "In the label, try to include text that mirrors the title of the linked site". Because we cannot control titles of linked sites, we're bound to produce errors against the style which Vale would incorrectly flag.
Excluding the content of link and xref descriptions would produce fewer false positives and help writers see the relevant recommendations.
I think we can fix this with scoping or similiar. need to investigate.
Is your feature request related to a problem? Describe. If you use the names of utilities or applications in xref and link descriptions, vale reports a warning. I have often several of these false positives in my vale reports.
Example:
Configure the WireGuard server by using xref:proc_configuring-a-wireguard-by-using-nmcli_assembly_setting-up-a-wireguard-vpn[nmcli].
causes:
Describe the solution you'd propose Disable spell checker in link and xref descriptions.
Describe alternatives you've considered Provide a simple way for writers to add the names of utilities, etc. to the spell checker list of vale.