> On 27 Nov 2019, at 1:13 pm, Carsten Bormann <c...@tzi.org> wrote:
>
> On Nov 27, 2019, at 02:56, Mark Nottingham <m...@mnot.net> wrote:
>>
>> Do we expect most readers to be comparing the documents so closely? This is
>> an 'obsoletes', not an 'updates'.
>
> Speaking for myself as a reader only: Yes.
My concern is that every time we add text to a document, we increase the
cognitive load for readers; adding the reasoning for *every* decision and
change expands a page of text into 2 to 3 (or more), so we need to impose a
filter of some sort.
The requirement in question is:
"Media type definitions (as per [RFC6838]) SHOULD specify the fragment
identifier syntax(es) to be used with them"
It was removed because it was misleading (6838 doesn't make such a requirement
a SHOULD), and the focus of this update was to reduce the number of unnecessary
requirements. 3986 isn't replacing that reference; it's providing a grounding
for what fragment identifiers are.
IME this information doesn't help the reader understand the document any better
unless they're closely comparing the two documents (as reviewers are now doing,
and thanks to them). If folks disagree, that's fine, but I'd like to understand
why they think this information is worthy of documenting in-spec.
Cheers,
--
Mark Nottingham https://www.mnot.net/
_______________________________________________
Gen-art mailing list
Gen-art@ietf.org
https://www.ietf.org/mailman/listinfo/gen-art