Re: [rfc-i] Guidance on linking added to the Web Portion of the Style Guide

Martin,

On 2/21/24 5:15 PM, Martin J. Dürst wrote:
> Hello Jean, others,
> 
> The Style Guide you cite says:
> 
>  >>>>
> An in-text citation may a) follow the subject for which it is being 
> cited as a silent pointer to the referenced document or b) be read as 
> part of the text.
> For example:
> 
> a) As part of the transition to IPv6, NAT64 [RFC6146] and DNS64 
> [RFC6147] technologies will be utilized by some access networks to 
> provide IPv4 connectivity for IPv6-only nodes [RFC6144].
> 
> or
> 
> b) Note that SAVI raises a number of important privacy considerations 
> that are discussed more fully in [RFC6959].
>  >>>>
> 
> I'm confused by the words "silent" and "read". Whereas the citation in 
> b) clearly cannot be silent, the citations in a) could be silent or 
> spoken/read. It's also not clear whether silent/read refer to screen 
> readers (accessibility) or to a general reading process (orally or just 
> mentally).

[JM] The RPC is working on clarifying this guidance. Thanks for calling 
out the issue.

Best regards,
Jean

> 
> Regards,   Martin.
> 
> 
> On 2024-02-21 23:37, Jean Mahoney wrote:
>> Hi all,
>>
>> The RPC has added guidance on the use of links in documents. Please 
>> see the Web Portion of the Style Guide at
>> <https://www.rfc-editor.org/styleguide/part2/#links>.
>>
>> Best regards,
>> Jean
>>
>>
>> _______________________________________________
>> rfc-interest mailing list
>> rfc-interest@rfc-editor.org
>> https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest