Re: [Acme] Dnsdir last call review of draft-ietf-acme-integrations-15

["Owen Friel (ofriel)" <[e-mail]>]

As Michael says, in -14 and earlier, we were verbatim without change copying text from RFC8499.

And the latest -15 abridges the text to remove quoting of the offending text from RFC8499.

If neither of the above are acceptable, how about this text:

"The terms Label, Domain Name, Subdomain and FQDN are used throughout this document. Please refer to [RFC8499] for a definition of these terms."

-----Original Message-----
From: Michael Richardson <[e-mail]> 
Sent: Friday, June 9, 2023 2:58 PM
To: Ted Lemon <[e-mail]>; Warren Kumari <[e-mail]>
Cc: [e-mail]; [e-mail]; [e-mail]; [e-mail]
Subject: Re: Dnsdir last call review of draft-ietf-acme-integrations-15


WARREN:

Ted Lemon via Datatracker <[e-mail]> wrote:
    > Frustratingly, the -15 update makes the document worse as a result of
    > my initial comments, not better. I think the authors didn't understand
    > why I made the comments, and hence are just trying to get rid of the
    > text that I commented on rather than fixing it. I actually suggested a
    > better way to write the text, in the initial review, which may have
    > gotten lost:

Hi, I appreciate your frustation.
You complained gently about text that wasn't ours.  It was copied from RFC8499.
We quoted the definitions to save you a trip to RFC8499 and back.

That's an entire RFC *JUST* for DNS Terminology.  Were you aware of this?
Was WARREN aware when he asked us to look at your nit, aware of that?

If using RFC8499 definitions is wrong in a document that deals a lot about DNS, then we really really have a problem.  Especially for a DNS Directorate REVIEW.

Editing the definitions would just lead to confusion as people wondered why we changed things.  Abridging things to omit the words you found unhelpful at least makes it clear we aren't trying to change things.
My co-author suggested we just rip all our text out.

    >> I'm not seriously proposing that you make this change, but if you
    >> don't, I think you should delete the sentence about graph theory,
    >> because it's just confusingly broad if you don't then actually
    >> describe the subset of graph theory you're talking about.

    > So, as an example, I did not suggest removing the text about
    > fully-qualified domains, which was fine, and is now not fine, in the
    > sense that the reader will have no idea why they are being mentioned.

We shortened it to what we thought was essential, but maybe we cut too much.

--
]               Never tell me the odds!                 | ipv6 mesh networks [
]   Michael Richardson, Sandelman Software Works        | network architect  [
]     [e-mail]  http://www.sandelman.ca/        |   ruby on rails    [






--
Michael Richardson <[e-mail]>, Sandelman Software Works
 -= IPv6 IoT consulting =-                      *I*LIKE*TRAINS*