Re: [MBONED] Mirja Kühlewind's No Objection on draft-ietf-mboned-driad-amt-discovery-09: (with COMMENT)

"Holland, Jake" <jholland@akamai.com> Wed, 18 December 2019 23:27 UTC

Return-Path: <jholland@akamai.com>
X-Original-To: mboned@ietfa.amsl.com
Delivered-To: mboned@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 090EB12004D; Wed, 18 Dec 2019 15:27:31 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.701
X-Spam-Level:
X-Spam-Status: No, score=-2.701 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=akamai.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 4ImswyhXDkGf; Wed, 18 Dec 2019 15:27:29 -0800 (PST)
Received: from mx0a-00190b01.pphosted.com (mx0a-00190b01.pphosted.com [IPv6:2620:100:9001:583::1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 705A2120013; Wed, 18 Dec 2019 15:27:29 -0800 (PST)
Received: from pps.filterd (m0050095.ppops.net [127.0.0.1]) by m0050095.ppops.net-00190b01. (8.16.0.42/8.16.0.42) with SMTP id xBINOhfs001454; Wed, 18 Dec 2019 23:27:29 GMT
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=akamai.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-id : content-transfer-encoding : mime-version; s=jan2016.eng; bh=6I2/xaipd6wa3tKxIqfHLJHV9ThwvTaryI+sTs05Ilc=; b=e5IIKoYkEt/QdUvRbpy5CdJzuvxIqycU+FonSXD8k/NBbtBXmXN8x9B1JmZMJoiQSSYy 6IWypI24n3bOSBIP56JZ4wulPVjU2jWS+mNv9axc+940DNV+ux3b4sKI2+w5jGxslMTr qzFZ/ZXfKYKfPdgZ1IwusB3DZyA0NB4sx6CgHG32l8X88zQq93YRBKHbpITHcZpaqJEN /PWKqsXFDJQHb8s83dBiU6GQB96Y17GAd53yScsB56mxi517u7C3Q6bZKPXNCMzZFKA0 lTZf5ensNAIDJzAI1ebVPtGnCEO7Ck/Pk/S7ETPUSgvtGkgDRuOcNjNAiGb2lOJxDfDc Hg==
Received: from prod-mail-ppoint4 (prod-mail-ppoint4.akamai.com [96.6.114.87] (may be forged)) by m0050095.ppops.net-00190b01. with ESMTP id 2wvr59bdnn-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 18 Dec 2019 23:27:28 +0000
Received: from pps.filterd (prod-mail-ppoint4.akamai.com [127.0.0.1]) by prod-mail-ppoint4.akamai.com (8.16.0.27/8.16.0.27) with SMTP id xBINHwir020175; Wed, 18 Dec 2019 18:27:27 -0500
Received: from email.msg.corp.akamai.com ([172.27.165.112]) by prod-mail-ppoint4.akamai.com with ESMTP id 2wvuy5kjkn-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Wed, 18 Dec 2019 18:27:21 -0500
Received: from ustx2ex-dag1mb6.msg.corp.akamai.com (172.27.165.124) by ustx2ex-dag1mb6.msg.corp.akamai.com (172.27.165.124) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Wed, 18 Dec 2019 15:27:15 -0800
Received: from ustx2ex-dag1mb6.msg.corp.akamai.com ([172.27.165.124]) by ustx2ex-dag1mb6.msg.corp.akamai.com ([172.27.165.124]) with mapi id 15.00.1473.005; Wed, 18 Dec 2019 15:27:15 -0800
From: "Holland, Jake" <jholland@akamai.com>
To: Mirja Kühlewind <ietf@kuehlewind.net>, The IESG <iesg@ietf.org>
CC: "draft-ietf-mboned-driad-amt-discovery@ietf.org" <draft-ietf-mboned-driad-amt-discovery@ietf.org>, "mboned-chairs@ietf.org" <mboned-chairs@ietf.org>, "mboned@ietf.org" <mboned@ietf.org>
Thread-Topic: [MBONED] Mirja Kühlewind's No Objection on draft-ietf-mboned-driad-amt-discovery-09: (with COMMENT)
Thread-Index: AQHVsRjyruPxaxO9j0O94VrFXq5sX6fAkykA
Date: Wed, 18 Dec 2019 23:27:15 +0000
Message-ID: <A196267D-1057-4529-94C1-F204C974BE9A@akamai.com>
References: <157617486973.21015.5661961518402669586.idtracker@ietfa.amsl.com>
In-Reply-To: <157617486973.21015.5661961518402669586.idtracker@ietfa.amsl.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/10.20.0.191208
x-ms-exchange-messagesentrepresentingtype: 1
x-ms-exchange-transport-fromentityheader: Hosted
x-originating-ip: [172.19.80.250]
Content-Type: text/plain; charset="utf-8"
Content-ID: <3272298E30A0384898F02CDBD67A2E84@akamai.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-12-18_08:, , signatures=0
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1911140001 definitions=main-1912180173
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.95,18.0.572 definitions=2019-12-18_08:2019-12-17,2019-12-18 signatures=0
X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 bulkscore=0 phishscore=0 priorityscore=1501 clxscore=1011 suspectscore=0 lowpriorityscore=0 impostorscore=0 spamscore=0 mlxscore=0 malwarescore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-1910280000 definitions=main-1912180173
Archived-At: <https://mailarchive.ietf.org/arch/msg/mboned/Z_KfQ3s-B6-YVjdnbEfcjYRVofI>
Subject: Re: [MBONED] Mirja Kühlewind's No Objection on draft-ietf-mboned-driad-amt-discovery-09: (with COMMENT)
X-BeenThere: mboned@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Mail List for the Mboned Working Group <mboned.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/mboned>, <mailto:mboned-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/mboned/>
List-Post: <mailto:mboned@ietf.org>
List-Help: <mailto:mboned-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/mboned>, <mailto:mboned-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 18 Dec 2019 23:27:31 -0000

Hi everyone, and thanks for all the reviews and comments.

I just posted -11:
https://tools.ietf.org/html/draft-ietf-mboned-driad-amt-discovery-11

I believe it contains all the proposed edits I've accepted in the recent
threads, with one outstanding exception remaining, regarding the comment
from Mirja and my response (below).

This change seems to me like a fairly major editorial restructuring, and
it wasn't exactly the suggested change, so I wanted to ask for confirmation
on whether it seems like an improvement?  (And also whether anyone agrees
or disagrees with me that it seems better than swapping the 3. Examples
section wholesale with the current section 2?)

Aside from this pending change, I believe the -11 version incorporates all
the changes I've made in response to the many excellent reviews and comments
over the last several days.  Thanks everyone, and please let me know if
you notice anything that might be missing, or of course if there are further
comments (I think not everyone has had a chance to confirm yet whether the
changes addressed all their concerns.)

Best regards,
Jake


<outstanding-proposed-edit>
> 4) Editorial: I would recommend to have the examples (section 3) before section
> 2.

I think moving the section is a little tricky.  I'm not sure the examples
make much sense without the context established in sections 2.1 and
2.2, but I can see why it might make sense to break up section 2 between
2.2 and 2.3, and to put the examples section in-between, and now that you
mention it, might improve the document.

What do you think of this structure?

Section 2 title "Relay Discovery Operation" -> "Relay Discovery Overview"
Section 2.1 title "Overview" -> "Basic Mechanics"
Section 3 "Examples" moved to section 2.3
Section 2 end after new section 2.3 (previously Section 3 examples)

New section 3 titled "Relay Discovery Overview"
Section 2.3 onward becomes new section 3.1

Do you think that would be a worthwhile reordering?  Do you think it would
need any other changes?

I can see that having the examples before the more detailed sections about
relay discovery operation might improve the doc for those reading it in
order, I think that's a good point.  Thanks.
</outstanding-proposed-edit>