IETF Logo Mail Archive

[Tools-discuss] Re: documents by WG --- RFCs and related documents -- are there APIs

Jay Daley <exec-director@ietf.org> Fri, 01 August 2025 04:01 UTC

Return-Path: <jay@staff.ietf.org>
X-Original-To: tools-discuss@mail2.ietf.org
Delivered-To: tools-discuss@mail2.ietf.org
Received: from localhost (localhost [127.0.0.1]) by mail2.ietf.org (Postfix) with ESMTP id CF4F44E1E784 for <tools-discuss@mail2.ietf.org>; Thu, 31 Jul 2025 21:01:08 -0700 (PDT)
X-Virus-Scanned: amavisd-new at ietf.org
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: mail2.ietf.org (amavisd-new); dkim=pass (2048-bit key) header.d=staff-ietf-org.20230601.gappssmtp.com
Received: from mail2.ietf.org ([166.84.6.31]) by localhost (mail2.ietf.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id NnJi49er4FPc for <tools-discuss@mail2.ietf.org>; Thu, 31 Jul 2025 21:01:05 -0700 (PDT)
Received: from mail-pj1-x1029.google.com (mail-pj1-x1029.google.com [IPv6:2607:f8b0:4864:20::1029]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by mail2.ietf.org (Postfix) with ESMTPS id 45D9B4E1E776 for <tools-discuss@ietf.org>; Thu, 31 Jul 2025 21:01:05 -0700 (PDT)
Received: by mail-pj1-x1029.google.com with SMTP id 98e67ed59e1d1-31ece02ad92so1399260a91.2 for <tools-discuss@ietf.org>; Thu, 31 Jul 2025 21:01:05 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=staff-ietf-org.20230601.gappssmtp.com; s=20230601; t=1754020864; x=1754625664; darn=ietf.org; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=47SDK+gewu6EM0E79eKAle/JnMCXXQZwRbkGTegpR7Q=; b=hbdOWX/r+KthUrW8C/fzygRlzxw2HGyS3g4iUZE5evOucKlvziSn30Xr89MYHRzUI5 797cK2/xpF4+iLipXjhO8qGTTM77OoesCtT9aHUebegFzmfOnZ3s/du3W10YQ2aBBRL+ Az4/oKGHGYRJZdGljIZfG0ZJyBC6iZJOWVFLRl/PbRXQeXeeSzJnn1RsT+kjixAWXIKZ aP1bNExPmFJT4lFxlnm98sQpI1q/p9UxW4E4d8cWi/JW2sreN5t1aDnGUMOTzwNRYg6A VLeMk3VNBuIwmmViWVo+d2DGcMz3gLiCjkIrvq39mL+G2xQHyJ/PspMvZ9tpGDXZ9ort xi/g==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1754020864; x=1754625664; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=47SDK+gewu6EM0E79eKAle/JnMCXXQZwRbkGTegpR7Q=; b=mH13OvWs4r+pvcXy/k5zL3ZDQ/RhRBv0vaScQkLMCWASXbtj90/AdoTtjiDIRA3nrg DC/GSxJ8ExwQ5VfE3kT6sBP2niPx1IcDAnuaMgzM8QYHbbA4D0j6Mu+ZVRosEWhwONl2 r+e2VkdIY96+4jf1Tt+QBeByfEhVCqUhZanGjMPOLYPTDNzahqG4E9UwPALp/BeOObqD vnYBMhYP7yGDs4en5k56FiJ6XWCgT9SG/TrS735g4Yr/sUBiKptSLZF5aj26qb8wVzeL qoiN3ZWUgb9xvVyZ7wwpg/TqNI2giZOUMYh1AZMcCb8qeMobCTGONubceDaS1ZEehkOC V5Eg==
X-Forwarded-Encrypted: i=1; AJvYcCWGloUMNU2fqKPjHq/dYbSVyKLqTX11HJykKEx7cMbz1YI6iWwh85ihwzw2GrnVbQZqYLLFaQbopKkp5Rpd@ietf.org
X-Gm-Message-State: AOJu0YzSOTuy/+4Ad2S5jBNpz5GY2ei+RCqcc0GTdnli2bfc1uW508dB 3ocrC+MuCYFHAtdiO7vM1u3QDs1SC/SsuwA/+uc1sfpLpVqhcP9tSWYflcmkVFHlm0saD26h73r +p9vxRc9PrQ==
X-Gm-Gg: ASbGncs6EckpcyUAUp/jTvG/lTKf7CgIwlcIDCNWLue/9lDXDETqK764a4YhYaJjeuo 3TlZsH29U0glcFs7IaBVwir8QlQErLnTS+UhajkbF9GvvXS2VpjRoninKzIpbLGSW6VSEBkwEQ0 3Iu1DC26kxLhg/MSLxVQ8JocgLeB6u7XFdTDoOLbs6mnVaiqyVWwVH6aU23R0cdd5eGwGiefAid WIWaPycb7vINePgSJ8vgqBifSkExNQvaC7D7Vi3Cp36yBi2Mgb4WeB0hmuweV0GjWICJFSbGdV6 //7c0qwbhlS+GsnHxGV7rFZeP6c+uf4nBEKg2RlEM5f3pxgL4FMWKpdrZpttNs4/72Ecf/5t+o9 wUNdBC4z9pjBIHCFQrY3TSDCk/5c+ThG+vR/Z7zgBXoJePuqGNui+AzhZt4YdxBzaCRYwNA5Fww Ns1874UJPH9ZM7uJopQws=
X-Google-Smtp-Source: AGHT+IFqg7AOhnt4rAW1NGUB87yw9Wjxc9TaTzaNvAFtIttVvvUHSKaajWnybECU9SiWxcqtQ6QAQg==
X-Received: by 2002:a17:90b:3890:b0:31f:2ee3:1ab7 with SMTP id 98e67ed59e1d1-31f5de65667mr11625893a91.32.1754020864161; Thu, 31 Jul 2025 21:01:04 -0700 (PDT)
Received: from smtpclient.apple (203-96-136-193.dsl-dynamic.connections.net.nz. [203.96.136.193]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-320fb7031f0sm687606a91.12.2025.07.31.21.01.01 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 31 Jul 2025 21:01:03 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3826.700.81\))
From: Jay Daley <exec-director@ietf.org>
In-Reply-To: <04C1C600-105E-4D91-9049-F343050AF536@bangj.com>
Date: Fri, 01 Aug 2025 16:00:49 +1200
Content-Transfer-Encoding: quoted-printable
Message-Id: <99885A7F-7143-4A89-8FEC-3E5C1E6057A7@ietf.org>
References: <523a3640-feab-4eeb-9b98-09eb6438923c@staff.ietf.org> <9215E610-26BC-4110-A319-66C85E7C2A4F@bangj.com> <17410.1753897913@obiwan.sandelman.ca> <04C1C600-105E-4D91-9049-F343050AF536@bangj.com>
To: Tom Pusateri <pusateri@bangj.com>
X-Mailer: Apple Mail (2.3826.700.81)
Message-ID-Hash: 53BRCVRB2YU6LVVAWF23YRJKCVWYS7NJ
X-Message-ID-Hash: 53BRCVRB2YU6LVVAWF23YRJKCVWYS7NJ
X-MailFrom: jay@staff.ietf.org
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-tools-discuss.ietf.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
CC: Michael Richardson <mcr+ietf@sandelman.ca>, tools-discuss@ietf.org
X-Mailman-Version: 3.3.9rc6
Precedence: list
Subject: [Tools-discuss] Re: documents by WG --- RFCs and related documents -- are there APIs
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/C0I64EwjpV0Ax6fqoJRgG5lz2Oc>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Owner: <mailto:tools-discuss-owner@ietf.org>
List-Post: <mailto:tools-discuss@ietf.org>
List-Subscribe: <mailto:tools-discuss-join@ietf.org>
List-Unsubscribe: <mailto:tools-discuss-leave@ietf.org>

Tom

> On 31 Jul 2025, at 06:18, Tom Pusateri <pusateri@bangj.com> wrote:
> 
> Well, that’s the whole point of a versioned API. When you make model changes, you do so in a way that preserves the old API too. And while you offer a new (v2) API, you never break the old API.
> 
> It’s just a choice when adding new features. You can choose to break the old API or you can choose to preserve it.

You make it sound like a zero-cost choice when in practice it can be, and is in our case, a very expensive choice to make.

Jay

-- 
Jay Daley
IETF Executive Director
exec-director@ietf.org

v2.39.1 | Report a Bug | By Email | System Status