[eppext] AD review of draft-ietf-eppext-tmch-smd-03

Barry Leiba <barryleiba@computer.org> Fri, 20 November 2015 20:28 UTC

Return-Path: <barryleiba@gmail.com>
X-Original-To: eppext@ietfa.amsl.com
Delivered-To: eppext@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 059A41B3D51; Fri, 20 Nov 2015 12:28:45 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: 0.621
X-Spam-Level:
X-Spam-Status: No, score=0.621 tagged_above=-999 required=5 tests=[BAYES_40=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FM_FORGED_GMAIL=0.622, FREEMAIL_FROM=0.001, SPF_PASS=-0.001] autolearn=no
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 bePy3G7e2qOg; Fri, 20 Nov 2015 12:28:44 -0800 (PST)
Received: from mail-vk0-x22d.google.com (mail-vk0-x22d.google.com [IPv6:2607:f8b0:400c:c05::22d]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D20BE1B3D50; Fri, 20 Nov 2015 12:28:40 -0800 (PST)
Received: by vkay187 with SMTP id y187so5257523vka.3; Fri, 20 Nov 2015 12:28:39 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:date:message-id:subject:from:to:cc:content-type; bh=GXtDVDcqASs5P98HCpiVVw8Ck11G704ehHzLmeQ1FZE=; b=Nwxn7DY7mN+gdeKDZEs6ewkSxa1zxBtmZsRv6y0bEEIUiL3PgXtxru5GlH5Wdy4k8l oOq6hEIj+jqu1oFNpYmErRd4M7g+BT7p4r5md2fwDAnxp5ZRmmeKI02igekMx/Qv2F6t JWFYDLi+Vl3PZdAF79TRYYNkcFFsruiRJqLLqTm5K/uYvXDXUAxHDwnExk6woESLrHGm lmj9+0buVeccDoEIgjWCB9xDD5Y+BacPHHAJ+8cjN495oTK2pxD3wk+UZn4caA1lAkUE IVp1C4Wd+hAP++FSxK1stPCAdqUkBH/P54fxpQ0sRLL0c/O0/kpkHHezd8VSGAmaMjFr JwcQ==
MIME-Version: 1.0
X-Received: by 10.31.107.193 with SMTP id k62mr1343714vki.27.1448051319869; Fri, 20 Nov 2015 12:28:39 -0800 (PST)
Sender: barryleiba@gmail.com
Received: by 10.31.182.135 with HTTP; Fri, 20 Nov 2015 12:28:39 -0800 (PST)
Date: Fri, 20 Nov 2015 15:28:39 -0500
X-Google-Sender-Auth: NozA1pW98IGJxosuFBtRUfE3hZQ
Message-ID: <CALaySJJ6f0uG2v0yh=7AbYq=WLnGSrzpFFBqHRXpDi6HREWtaQ@mail.gmail.com>
From: Barry Leiba <barryleiba@computer.org>
To: draft-ietf-eppext-tmch-smd@ietf.org
Content-Type: text/plain; charset="UTF-8"
Archived-At: <http://mailarchive.ietf.org/arch/msg/eppext/ILawAHAXEJ2o6xrXs9UXR5qUtEU>
Cc: eppext <eppext@ietf.org>
Subject: [eppext] AD review of draft-ietf-eppext-tmch-smd-03
X-BeenThere: eppext@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: EPPEXT <eppext.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/eppext>, <mailto:eppext-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/eppext/>
List-Post: <mailto:eppext@ietf.org>
List-Help: <mailto:eppext-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/eppext>, <mailto:eppext-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 20 Nov 2015 20:28:45 -0000

As with the keyrelay document, please accept my apology for the delay
in processing this.  And as with that document, my comments are just
the most minor editorial things, and I will request last call as soon
as I send this message.

-- Section 2.1 --
First, is it assumed that if an element is not marked as OPTIONAL,
it's REQUIRED?  Would it be good to state that at the top?

Second, I have a general aversion to saying, "X is OPTIONAL... except
that it's not optional in a particular situation."  (It's less
confusing, I think, to reverse that.)  What you really mean in the
first two "child elements" bullets is that you MUST specify at least
one of <mark:name> and <mark:org>.  It might be better to say it that
way.  Maybe this?:

OLD
   *  An OPTIONAL <mark:name> element that contains the name of the
      holder.  A <mark:name> MUST be specified in case <mark:org> is
      not specified.

   *  An OPTIONAL <mark:org> element that contains the name of the
      organization holder of the mark.  A <mark:org> MUST be
      specified in case <mark:name> is not specified.

NEW
   *  A <mark:name> element that contains the name of the holder.
      At least one of <mark:name> and <mark:org> MUST be specified,
      and <mark:name> is OPTIONAL if <mark:org> is specified.

   *  A <mark:org> element that contains the name of the organization
      holder of the mark.  At least one of <mark:name> and <mark:org>
      MUST be specified, and <mark:org> is OPTIONAL if <mark:name> is
      specified.

END

-- Section 2.5 --
It's a little odd to have this say "Appendix A" in the section title, no?

Is there any real value in including the entire, 2.5-page-long base64?
 Is it really intended that anyone will extract that from the document
and decode it?  Or is the point just to show how the base64 data is
wrapped in the encodedSignedMark element?  If so, why not just this?:

NEW
 <smd:encodedSignedMark
    xmlns:smd="urn:ietf:params:xml:ns:signedMark-1.0">
 PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHNtZDpzaWduZWRNYXJ
 rIHhtbG5zOnNtZD0idXJuOmlldGY6cGFyYW1zOnhtbDpuczpzaWduZWRNYXJrLTEuMCIgaW
 ... (base64 data elided for brevity) ...
 PC9zbWQ6c2lnbmVkTWFyaz4=
 </smd:encodedSignedMark>
END

--
Barry