Re: [rfc-i] I-D Action: draft-rpc-rfc7322bis-00.txt

[Brian E Carpenter <[e-mail]>]

On 05-May-23 03:16, Jean Mahoney wrote:
> Hi all,
> 
> The I-D draft-rpc-rfc7322bis replaces draft-flanagan-7322bis. 

Thanks Jean. I had a look at the diffs since RFC7322 itself and
most of them seem fine to me. Some quibbles, however:

> Angle brackets are strongly recommended around URIs [STD66], e.g.,	
> 		 		
> <https://example.com/>

I understand the need for a delimiter, but I have a use case where
the intent is to refer to a URI as a string, so "https://example.com/"
is much more appropriate. Could that be:

   Delimiters such as angle brackets are strongly recommended...

As a matter of fact, STD66 says this:

    In practice, URIs are delimited in a variety of ways, but usually
    within double-quotes "http://example.com/", angle brackets
    <http://example.com/>, or just by using whitespace:
       http://example.com/

so double quotes are just as "legal" as angle brackets.

> The use of HTTPS rather than HTTP is strongly encouraged.

I'm not sure that is an editorial or style issue. Also, it should
never lead to an editorial change, only to a query, since there
may be cases where HTTP is intended. Again, I have a use case in
a current draft.

> 7.  A citation may A) follow the subject to which the citation	
> applies 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].	
> 		 		
>  b.  Note that SAVI raises a number of important privacy	
>      considerations that are discussed more fully in [RFC6959].	
> 		 		
> 8.  For a document referenced multiple times in running text, the	
>     citation anchor must be at first use outside the abstract.	
>     Additional citations are allowed at the author's discretion.	
> 		 		
> We recommend using A) and strongly recommend consistent use of one	
> style throughout.

A nit here is that the "We recommend" sentence should surely be part
of item 7, not after item 8. More substantively, I don't agree with
the *strong* recommendation for consistency. I agree that A) is generally
better practice, but in a long document, cases where B) leads to more
readable text can occur. Something like:

   We recommend using A) in most cases, and limiting B) to cases where
   it enhances readability.

Regards,
    Brian