-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

In message <[email protected]>, Alessandro
Vesely <[email protected]> writes

>On Wed 27/Aug/2025 16:46:28 +0200 Richard Clayton wrote:
>> 
>>>   Title:   DomainKeys Identified Mail Signatures v2 (DKIM2)
>> 
>> This draft is modelled on RFC 6376 and is intended to set out a formal
>> specification of DKIM2-Signature fields.
>
>
>I found that document quite confusing to read.  

difficult to address that comment without more detail .... I've had
others suggest that text about canonicalisation and header fields more
generally could be rather better arranged and I tend to agree...

>At one point I ran iddiff on 
>RFC 6376 and tried to read only the changes.  It is still a pain to do.

of course rearranging things to improve the flow will make that
completely impractical !  and do you really want to learn that the NITS
system thinks it should be "public key" and not "public-key" ?

>Wouldn't readability improve if you assumed full familiarity with RFC 6376 and 
>focus on the differences?  

the document explicitly stresses the things that are the same as DKIM1
(the keys, the (implicit) use of relaxed/relaxed) but after that there's
not that much that is identical -- so I don't think this would be
especially helpful and it would be quite a lot of work

>I understand that in the future people will want to 
>learn the current version of DKIM without having to wade through historical 
>artifacts.  For now, however, leveraging people's knowledge of DKIM1 could be 
>an advantage.

I think that is something for overview documents to address ... this
draft is concentrating on the DKIM2-Signature header field and I have
tried to remove all the material that is about the scheme in general
(and I suspect more of the later pages could go)

- -- 
richard @ highwayman . com                       "Nothing seems the same
                          Still you never see the change from day to day
                                And no-one notices the customs slip away"

-----BEGIN PGP SIGNATURE-----
Version: PGPsdk version 1.7.1

iQA/AwUBaLCvI2HfC/FfW545EQIaBQCfaZ9v3ahcVr1i0LRvHv+fEPWzvPwAoNmA
Gz7pD0tDPoexQRd3AZ2/EOsX
=YtQu
-----END PGP SIGNATURE-----

_______________________________________________
Ietf-dkim mailing list -- [email protected]
To unsubscribe send an email to [email protected]

Reply via email to