IETF Logo Mail Archive

Re: [Rats] CDDL terminology (was Re: I-D Action: draft-ietf-rats-eat-15.txt)

Thomas Fossati <tho.ietf@gmail.com> Mon, 03 October 2022 15:15 UTC

Return-Path: <tho.ietf@gmail.com>
X-Original-To: rats@ietfa.amsl.com
Delivered-To: rats@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 210EEC1522B6 for <rats@ietfa.amsl.com>; Mon, 3 Oct 2022 08:15:26 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.109
X-Spam-Level:
X-Spam-Status: No, score=-2.109 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id ZlEsgy3V_bzL for <rats@ietfa.amsl.com>; Mon, 3 Oct 2022 08:15:21 -0700 (PDT)
Received: from mail-vk1-xa29.google.com (mail-vk1-xa29.google.com [IPv6:2607:f8b0:4864:20::a29]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A462FC14F74E for <rats@ietf.org>; Mon, 3 Oct 2022 08:15:21 -0700 (PDT)
Received: by mail-vk1-xa29.google.com with SMTP id w139so1446741vkw.7 for <rats@ietf.org>; Mon, 03 Oct 2022 08:15:21 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date; bh=+tFF8DUpSeDI1Uoxm2Ay6sBB9tnxFWAVFU0B4X1x5sA=; b=TffEMb5+c8ENywttjsdPLcjWDoRc+6XNgM3TwBZ9I68NPuoNnSWj2KYl6SY1YXiRIw 1NCs8g4Egk4MnaHvNCnGE4MIP6psWcdjRSAfoWOZl1KdRx2+vFt3TIZ2uU5k9nBY0rpZ Nsqpl7jT5gUVWh1EFsCs0B2bc7aLuzE25YTHB6HF7Kvr0TFVLHE0ESdjw7xTXYBN86XL r8gw32hjYvHfFvyoj8ETWkcUSxodi7acwO00/MMJmfv4GNXzPmDOUCNC8ygfjA53+p3/ RwwRjwXxAUiHiOX/j7ZFFRUKSWjKISnDXJgAYf6FHehkZLUYfyA90OmTvo7x8Sd5mEz0 AmVQ==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date; bh=+tFF8DUpSeDI1Uoxm2Ay6sBB9tnxFWAVFU0B4X1x5sA=; b=IZmgZCNKUe8yfCQIC9nr/hPLAPPKSXmR/3WDWCqxEOaRdU+79ZD6cHHUQ/uIUDUCrU QU2ogXVTr8cX382vkDltiiRuINKRSWoM78t4V0WSSrdZMwdvJB9akCzeeS/H6+dsVf7z 5lTgFfYhbq2RO5oloVoxuqDx2sEbdtuwCzh1vt9ioWuEguYoj2939cvxMnkYoGSDoDSw NEr+h6GsGGE9YycVzcvOWSODqOmCBmA2rzsyFHzjGWexwt5+JF/ke1P33kZknS4DXSMu RUM/CAkqHRbinZ2FIk9uLgcZjvyv3JYgwsmyMIOZgh+x58yT5VGFH8GG9tlf/1Ea82V7 C12A==
X-Gm-Message-State: ACrzQf3GahnmNfMZIz54QFtGbnrjaZV3eeTDmkCvaOAlThTE7whp0Ss2 Jdl8TVynWv8ZuANsr9mh/sEL6EFpQY+4J+Japfg=
X-Google-Smtp-Source: AMsMyM7Jf6nBbKjuO1hPtrOUYo/hZxswBVoDxFGi4mrdF/nnuSPLEd0S8GtYOJh5j7hoItgA95Hg+RddT/wXX3AXfnI=
X-Received: by 2002:a1f:294b:0:b0:3a9:a0be:6e4a with SMTP id p72-20020a1f294b000000b003a9a0be6e4amr5048360vkp.18.1664810120463; Mon, 03 Oct 2022 08:15:20 -0700 (PDT)
MIME-Version: 1.0
References: <166466905854.59321.12818330000633725430@ietfa.amsl.com> <869853.1664709443@dooku> <CAObGJnNwuuMLRhPa9xTW1b-OY19zLcpJqj9dreowPXsxtNJcvA@mail.gmail.com> <996453.1664712342@dooku> <CAObGJnPtRis6CSq-5krh7RgJrke4dxoWUrfZ-pzM-djH8EMU2w@mail.gmail.com> <81DF020D-A406-4F4B-BD4C-E525F9FA8E32@island-resort.com> <CAObGJnM1ietJW8hX2W3rD_JxWE7J6E9ZgLY-QN9foDnrN46k7A@mail.gmail.com> <DF5F25E3-444A-416D-B0B2-D11DD91B6264@intel.com>
In-Reply-To: <DF5F25E3-444A-416D-B0B2-D11DD91B6264@intel.com>
From: Thomas Fossati <tho.ietf@gmail.com>
Date: Mon, 03 Oct 2022 16:15:09 +0100
Message-ID: <CAObGJnMkJZAd9o4xLYKkdSmWB5TR=noLGvYSKYoFnqa7M83O6w@mail.gmail.com>
To: "Smith, Ned" <ned.smith@intel.com>
Cc: Laurence Lundblade <lgl@island-resort.com>, Michael Richardson <mcr+ietf@sandelman.ca>, "rats@ietf.org" <rats@ietf.org>
Content-Type: text/plain; charset="UTF-8"
Archived-At: <https://mailarchive.ietf.org/arch/msg/rats/lBkwpjSbTGaJOsYRtKUH3DSoQ5U>
Subject: Re: [Rats] CDDL terminology (was Re: I-D Action: draft-ietf-rats-eat-15.txt)
X-BeenThere: rats@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Remote ATtestation procedureS <rats.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rats>, <mailto:rats-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rats/>
List-Post: <mailto:rats@ietf.org>
List-Help: <mailto:rats-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rats>, <mailto:rats-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 03 Oct 2022 15:15:26 -0000

On Mon, Oct 3, 2022 at 3:56 PM Smith, Ned <ned.smith@intel.com> wrote:
>
> Sometimes its helpful to summarize in a few words what a particularly arcane term means. For example: "...the xyz structure is designed for extensibility; in CDDL, a "socket group" defines extensibility for map structures..."

I have made this https://github.com/ietf-rats-wg/eat/pull/317/files

It inlines a ref to the section in the CDDL RFC describing what
"socket" means.  It does that right after the term is first introduced
in the document.  I think a hyperlink provides a better UX than a term
(re)defined in a different visual frame.

-- 
Thomas

v2.23.0 | Report a Bug | By Email