Re: [rfc-i] getting SVG of RFC diagrams

Paul Kyzivat <pkyzivat@alum.mit.edu> Fri, 24 November 2023 23:51 UTC

Return-Path: <pkyzivat@alum.mit.edu>
X-Original-To: rfc-interest@ietfa.amsl.com
Delivered-To: rfc-interest@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 1B07AC151984 for <rfc-interest@ietfa.amsl.com>; Fri, 24 Nov 2023 15:51:27 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -7.008
X-Spam-Level:
X-Spam-Status: No, score=-7.008 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=alum.mit.edu
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 acuPrk0AfY2S for <rfc-interest@ietfa.amsl.com>; Fri, 24 Nov 2023 15:51:21 -0800 (PST)
Received: from NAM12-DM6-obe.outbound.protection.outlook.com (mail-dm6nam12on20623.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe59::623]) (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 B7D25C151553 for <rfc-interest@rfc-editor.org>; Fri, 24 Nov 2023 15:51:21 -0800 (PST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=HLLsJ5bwyQq0iUUIrATrvlTRYX7pRZHGEsYjs5sPMBf2AgoOwKXffEsUEpo0iWDDoKSL8ZcekbhnM7qVZGwrdMCQaZjCaMFBBHp9NbF1D7g+Ut1mxY2O9gUsqf6lof+kxd295cxTSigS3RJoZkUh6oNmHxCsE0OtJWRUK2e4ZUmOrbGRSQOBX43Xn06VL+Z49sJchWm2tDpP8M3WMUoEdWlJP7x9eV0hcbxV36QnbdGDhN8wwMcM2uP4fcssYrUignQj2Af+Q9NtU5gJ8VrZ2zDcpONH3N7iGJmKaHNNtyVckfy+jQGmH/1ut8MSs6y5RXhj6vySU+Urjacr1olynw==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=Y3sy6gWiuWwF9593sS7Uv4qdrUc5kmr56WzwrTZUdXI=; b=JRqtI3yUpsJ4U8kM8hUe+c/ql+bj76It3bM0BOLEXXuYYw0MCNrWLAYg5DOBth5KyRMwiWrGTdzwtMDoKobF6ViQVKHyFKRncFbI8dLLJhjFLi0lkedQwC4LDS6QrLsN0KpLyA60Ae0IW1JHJ0u/T1nb4ZSTgggOzrptuaSuqGBgjuJbjIpcTGiXR0F1okDt5zWPN0WD5US2fALpZ66PGbLlsr+QH8y8338OAgfvqDIRvmvMd/w+GHSIxtrxUlzTof7tNsqxbnsNwWwRm+pkZKR4zerPM8CMM2vB78W5bUA5rMFNTtOgSFa+g7t/fy7qA2t6tAK7viw+9wPslPKIEg==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 18.7.68.33) smtp.rcpttodomain=rfc-editor.org smtp.mailfrom=alum.mit.edu; dmarc=pass (p=none sp=none pct=100) action=none header.from=alum.mit.edu; dkim=none (message not signed); arc=none (0)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alum.mit.edu; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Y3sy6gWiuWwF9593sS7Uv4qdrUc5kmr56WzwrTZUdXI=; b=QjadRpivS+hR7DngpDyM52NX0mBd4I5cW5wZtv6PCSrjqhflYoQfeyU6cmxbCuk+9vkvDq8M69MdouAFfRlRuRgahRqcJvkw7hN73Ym45p/b7JRMhzW2H0k4dBXDyen4smOr5Uo/IMA+sncUy/Ok7xThZmjqzOvwnM5Q9HOW9rc=
Received: from MW4PR04CA0074.namprd04.prod.outlook.com (2603:10b6:303:6b::19) by DS7PR12MB5911.namprd12.prod.outlook.com (2603:10b6:8:7c::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7025.21; Fri, 24 Nov 2023 23:51:19 +0000
Received: from CO1PEPF000042AD.namprd03.prod.outlook.com (2603:10b6:303:6b:cafe::dc) by MW4PR04CA0074.outlook.office365.com (2603:10b6:303:6b::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7025.21 via Frontend Transport; Fri, 24 Nov 2023 23:51:19 +0000
X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 18.7.68.33) smtp.mailfrom=alum.mit.edu; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=alum.mit.edu;
Received-SPF: Pass (protection.outlook.com: domain of alum.mit.edu designates 18.7.68.33 as permitted sender) receiver=protection.outlook.com; client-ip=18.7.68.33; helo=outgoing-alum.mit.edu; pr=C
Received: from outgoing-alum.mit.edu (18.7.68.33) by CO1PEPF000042AD.mail.protection.outlook.com (10.167.243.42) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7046.17 via Frontend Transport; Fri, 24 Nov 2023 23:51:18 +0000
Received: from [192.168.1.52] (c-73-143-251-114.hsd1.ma.comcast.net [73.143.251.114]) (authenticated bits=0) (User authenticated as pkyzivat@ALUM.MIT.EDU) by outgoing-alum.mit.edu (8.14.7/8.12.4) with ESMTP id 3AONpGKM021850 (version=TLSv1/SSLv3 cipher=AES128-GCM-SHA256 bits=128 verify=NOT) for <rfc-interest@rfc-editor.org>; Fri, 24 Nov 2023 18:51:17 -0500
Message-ID: <9fd054a6-ed51-4ca6-8fbe-f7ff78bf3c8b@alum.mit.edu>
Date: Fri, 24 Nov 2023 18:51:16 -0500
MIME-Version: 1.0
User-Agent: Mozilla Thunderbird
Content-Language: en-US
To: rfc-interest@rfc-editor.org
References: <310371.1700735021@dyas> <7C81D316-7D04-4941-BEE5-6AE8C96F0DE1@tzi.org> <D1F8F86E-80D7-4FC7-B7B5-32648ACB5D65@tzi.org> <MN2PR11MB3757AF8CCDF388BA5CECFE1AB9B8A@MN2PR11MB3757.namprd11.prod.outlook.com> <153bde12-5773-42ce-bfdf-392e4492c06b@gmx.de> <MN2PR11MB375791C859512AB08EA20D11B9B8A@MN2PR11MB3757.namprd11.prod.outlook.com> <61DE9E4A-5242-42A9-B88D-30BEBF16AB0E@tzi.org> <MN2PR11MB3757F829830FBD6E1EB3C72FB9B8A@MN2PR11MB3757.namprd11.prod.outlook.com>
From: Paul Kyzivat <pkyzivat@alum.mit.edu>
In-Reply-To: <MN2PR11MB3757F829830FBD6E1EB3C72FB9B8A@MN2PR11MB3757.namprd11.prod.outlook.com>
Content-Type: text/plain; charset="UTF-8"; format="flowed"
Content-Transfer-Encoding: 8bit
X-EOPAttributedMessage: 0
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: CO1PEPF000042AD:EE_|DS7PR12MB5911:EE_
X-MS-Office365-Filtering-Correlation-Id: 50f48d1e-7f30-49e9-7f49-08dbed484145
X-MS-Exchange-SenderADCheck: 1
X-MS-Exchange-AntiSpam-Relay: 0
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: W1JSWaxGX1zPcwBAUjAOB92DfGrLxpowalTdOX7XgNSwsWgMIOEHyRJcU0TlosxhXP8WEFq14M8ukDhE/WNdeSDwVAsBFYCL1OOXxnHsnpIK9/FSe8l1Be/LeZj8VJ5D+NDBvjq6vvwgS0RNzTtbdFyVJA+Wy4Yn6uXlqjpQU1fmrD9+PBfzk68dfAxsqSQh7LKB8oiJPxVmD+sckQiQ5uSFTMapBojerlEsy9e9H/sUUIEzTzjA9Ia00ysNsMPfulsPGCR9b5r61xmjdzplFzWUbwa6yqxZMw2NUfFvW+csnB1ghn45fSoZYsBsXCCGgf+Qt5ZjyfOUjG7uJhzX0mi2i9xn05yZNwztFxXIbcDKi0f3s5PMjikg09Vl45V47HF0bA/uVbGn+RrlZGpq56wIoqmqgHjCX+e2yhUZIRZUDo6f9/AS3yGvph6HoMS4QdLmk391hPaeZB0h34zqlbm9CoMjwBCDE+QfB8lAn8nfrv93QRdgR3+1kyQvYuqxx5UX6I64g/ryEUkerozg99ASljJbmrysyczPAkUfpZZTQ1y4HSxWMLNitZwlKwZPNT00qP7NqO8WpIc8Ypjdj0BmWb+soDs8ZF6Mah91UdCzOUUIjPIpCP4D+JcC7+cF4CDT2XtwD5+ftYySSBEnak2fbMZA+LNvRMSZRdSzqMRwWPPoa545S0tIJip1kc+Cqe/W9o8duc7A+bsd0Snozanox183Q6i0nqARJIkIju567CJYLnyALwL+jhKRP873/03/AvSUWWEzNKBnboLGFA==
X-Forefront-Antispam-Report: CIP:18.7.68.33; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:outgoing-alum.mit.edu; PTR:outgoing-alum.mit.edu; CAT:NONE; SFS:(13230031)(346002)(39860400002)(376002)(136003)(396003)(230922051799003)(230173577357003)(230273577357003)(64100799003)(82310400011)(186009)(451199024)(1800799012)(46966006)(36840700001)(966005)(478600001)(53546011)(75432002)(82740400003)(2906002)(86362001)(5660300002)(4001150100001)(41300700001)(31696002)(6916009)(70206006)(70586007)(7596003)(8936002)(356005)(786003)(316002)(8676002)(41320700001)(2616005)(956004)(47076005)(83380400001)(26005)(336012)(31686004)(36860700001)(40480700001)(43740500002); DIR:OUT; SFP:1101;
X-OriginatorOrg: alum.mit.edu
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Nov 2023 23:51:18.6715 (UTC)
X-MS-Exchange-CrossTenant-Network-Message-Id: 50f48d1e-7f30-49e9-7f49-08dbed484145
X-MS-Exchange-CrossTenant-Id: 3326b102-c043-408b-a990-b89e477d582f
X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3326b102-c043-408b-a990-b89e477d582f; Ip=[18.7.68.33]; Helo=[outgoing-alum.mit.edu]
X-MS-Exchange-CrossTenant-AuthSource: CO1PEPF000042AD.namprd03.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Anonymous
X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DS7PR12MB5911
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-interest/7Wc4obA4_SrgmSWad4h-w5fh6tQ>
Subject: Re: [rfc-i] getting SVG of RFC diagrams
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://mailman.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
X-List-Received-Date: Fri, 24 Nov 2023 23:51:27 -0000

On 11/24/23 9:57 AM, Paul Duffy (paduffy) wrote:
> Inlining of any code snippets beyond a few lines long IMO is nothing more that aggravation and friction for the developer community that needs the ability to quickly inject the source into useful tooling.
> 
> And inlining often leads to a nearly unreadable mess in the RFC.
The inlining is needed in order to preserve the stability of RFC over 
time, regardless of what might happen to the original sources. You could 
of course put an explicit reference to the original source in your document.

An alternative that I think I have seen discussed, is to leave the 
reference but also have an IETF managed backup, that automatically takes 
over if the original link is broken. But there is much complexity here.

	Thanks,
	Paul

> -----Original Message-----
> From: Carsten Bormann <cabo@tzi.org>
> Sent: Friday, November 24, 2023 9:44 AM
> To: Paul Duffy (paduffy) <paduffy@cisco.com>
> Cc: rfc-interest@rfc-editor.org
> Subject: Re: [rfc-i] getting SVG of RFC diagrams
> 
> On 2023-11-24, at 15:39, Paul Duffy (paduffy) <paduffy=40cisco.com@dmarc.ietf.org> wrote:
>>
>> Help me understand.
>>
>> https://datatracker.ietf.org/doc/draft-duffy-csmp/
>>
>> Section 3.2.1
>>
>> Originally provided as link to external OpenAPI. Super easy for developer to import that link directly into OpenAPI tooling.
> 
> Makes sense during development.
> 
>> I was told this will not acceptable and must be inlined into the draft.
> 
> Once you enter WGLC and IESG processing, yes.
> 
> This leads to the desirability of the URI convention described by me.
> 
> Grüße, Carsten
> 
> _______________________________________________
> rfc-interest mailing list
> rfc-interest@rfc-editor.org
> https://mailman.rfc-editor.org/mailman/listinfo/rfc-interest