Re: [quicwg/base-drafts] Massive batch of probably-editorial nits (#3805)

[Martin Thomson <[e-mail]>]

@martinthomson commented on this pull request.



> @@ -4008,8 +3992,8 @@ off-path injection as specified in {{!RFC8201}} and Section 5.2 of {{!RFC8085}}.
 This validation SHOULD use the quoted packet supplied in the payload of an ICMP
 message to associate the message with a corresponding transport connection (see
 Section 4.6.1 of {{!DPLPMTUD}}).  ICMP message validation MUST include matching
-IP addresses and UDP ports {{!RFC8085}} and, when possible, connection IDs to an
-active QUIC session.  The endpoint SHOULD ignore all ICMP messages that fail
+IP addresses and UDP ports ({{!RFC8085}}) and, when possible, connection IDs to

I think that the prevailing use of external references - those that appear in brackets - is both inline "defined in [REF]" and not as an automatic parenthetical, but an annotation of a noun in cases like "such as UDP [REF]", which you would convert to something like `<a href="REF">UDP</a>` were this text.  That's harder to codify though.  In many ways this is a limitation of markdown, but I don't see it as a serious shortcoming, because fixes (such as those in HTML or XML) just transfer the problem to the presentation layer.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/quicwg/base-drafts/pull/3805#discussion_r452560291