Re: [Sat] Contributing to drafts is now easier - Core and Crash Recovery

Rafael Belchior <rafael.belchior@tecnico.ulisboa.pt> Tue, 23 January 2024 12:22 UTC

Return-Path: <rafael.belchior@tecnico.ulisboa.pt>
X-Original-To: sat@ietfa.amsl.com
Delivered-To: sat@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 1C028C14F68E for <sat@ietfa.amsl.com>; Tue, 23 Jan 2024 04:22:45 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.902
X-Spam-Level:
X-Spam-Status: No, score=-6.902 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FONT_INVIS_MSGID=0.001, HTML_FONT_LOW_CONTRAST=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, TRACKER_ID=0.1, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_BLOCKED=0.001, 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=tecnico.ulisboa.pt
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 WqbDbM6T6H0A for <sat@ietfa.amsl.com>; Tue, 23 Jan 2024 04:22:40 -0800 (PST)
Received: from smtp2.tecnico.ulisboa.pt (smtp2.tecnico.ulisboa.pt [193.136.128.22]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 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 56048C14F5EA for <sat@ietf.org>; Tue, 23 Jan 2024 04:22:37 -0800 (PST)
Received: from localhost (localhost.localdomain [127.0.0.1]) by smtp2.tecnico.ulisboa.pt (Postfix) with ESMTP id B48312455B1; Tue, 23 Jan 2024 12:22:34 +0000 (WET)
X-Virus-Scanned: by amavis-2.13.0 (20230106) (Debian) at tecnico.ulisboa.pt
Received: from smtp2.tecnico.ulisboa.pt ([127.0.0.1]) by localhost (smtp2.tecnico.ulisboa.pt [127.0.0.1]) (amavis, port 10025) with LMTP id UnvzQEEdm6dv; Tue, 23 Jan 2024 12:22:32 +0000 (WET)
Received: from mail1.tecnico.ulisboa.pt (mail1.ist.utl.pt [193.136.128.10]) by smtp2.tecnico.ulisboa.pt (Postfix) with ESMTPS id 100FC245592; Tue, 23 Jan 2024 12:22:32 +0000 (WET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tecnico.ulisboa.pt; s=mail; t=1706012552; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=O+BMlFDAU/2WyYDWRIXPCAwwMMK1xT3bIstrVV7VZIg=; b=AuMBKjJ96Ja97P5v46PYiECBBMFHzpu0QQyCSnz/80wNU8oqVEXU2KjuDcWG8ScFQ/R4T3 1qlyE8pSgpfsHfuIAdshLwkWXFK/PSWKSkfFoFELViLYNlarx6f6UJk0XPIFLOAyeq62hV 9+xIl2uQVb1MWH46u7ixlJo4VOXLtGQ=
Received: from webmail.tecnico.ulisboa.pt (webmail4.tecnico.ulisboa.pt [IPv6:2001:690:2100:1::8a3:363d]) (Authenticated sender: ist180970) by mail1.tecnico.ulisboa.pt (Postfix) with ESMTPSA id EDB02360088; Tue, 23 Jan 2024 12:22:31 +0000 (WET)
Received: from 2a02:2f05:f004:6600:5495:7bb4:4bb3:91c8 via vs1.ist.utl.pt ([2001:690:2100:1::33]) by webmail.tecnico.ulisboa.pt with HTTP (HTTP/1.1 POST); Tue, 23 Jan 2024 12:22:31 +0000
MIME-Version: 1.0
Date: Tue, 23 Jan 2024 14:22:31 +0200
From: Rafael Belchior <rafael.belchior@tecnico.ulisboa.pt>
To: VENKATRAMAN RAMAKRISHNA <vramakr2@in.ibm.com>
Cc: sat@ietf.org
In-Reply-To: <SJ0PR15MB5132C849241F36698D307C31B8742@SJ0PR15MB5132.namprd15.prod.outlook.com>
References: <2aac7d36c452d9446be9d261450baa07@tecnico.ulisboa.pt> <SJ0PR15MB5132C849241F36698D307C31B8742@SJ0PR15MB5132.namprd15.prod.outlook.com>
User-Agent: Roundcube Webmail
Message-ID: <44de8e08eb6578b825cf0ba5e99e50b9@tecnico.ulisboa.pt>
X-Sender: rafael.belchior@tecnico.ulisboa.pt
Content-Type: multipart/alternative; boundary="=_4623a0a411d6cbff0300c0a3ad5a1a0d"
Archived-At: <https://mailarchive.ietf.org/arch/msg/sat/l1YMNwgHRGU80ezhL0xngLfPctg>
Subject: Re: [Sat] Contributing to drafts is now easier - Core and Crash Recovery
X-BeenThere: sat@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: "The purpose of this mailing-list is to discuss the secure asset transfer \(SAT\) protocol and related aspects." <sat.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/sat>, <mailto:sat-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/sat/>
List-Post: <mailto:sat@ietf.org>
List-Help: <mailto:sat-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/sat>, <mailto:sat-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 23 Jan 2024 12:22:45 -0000


Rama,

I had to convert manually - cumbersome but not too hard. Kudos to Yaron, 
who helped me. If you use SATP-core and SATP-crash recovery as examples 
you have there most syntax you need to use. However, I would try 
Carsten's tool before doing everything manually.

Rafael

A 2024-01-23 13:29, VENKATRAMAN RAMAKRISHNA escreveu:

> Hi Rafael,
> 
> I'm catching up on this after a very long time.
> 
> These repositories look great, but is there a straightforward way for 
> me to convert a text file (either as a .txt or txt from a Word doc) to 
> markdown format so I can create a similar build structure around it? Or 
> do I need to manually create it?
> 
> IETF Datatracker allows submissions in different formats, one of which 
> is a plaintext file. That's the format I've been using thus far for the 
> SATP Use Cases draft (and the views drafts too).
> 
> Rama
> 
> From: sat <sat-bounces@ietf.org> On Behalf Of Rafael Belchior
> Sent: Thursday, October 26, 2023 12:15 AM
> To: sat@ietf.org
> Subject: [EXTERNAL] [Sat] Contributing to drafts is now easier - Core 
> and Crash Recovery
> 
> Hello Folks, I have been refactoring our SATP-Core repository to follow 
> IETF recommendations and guidelines for managing drafts in Github 
> (following i-d-template). Thanks Yaron for the help. Our build and 
> submission processes are now automated. 
> 
> ZjQcmQRYFpfptBannerStart
> 
> This Message Is From an External Sender
> 
> This message came from outside your organization.
> 
> Report Suspicious   [1]  ‌
> 
> ZjQcmQRYFpfptBannerEnd
> 
> Hello Folks,
> 
> I have been refactoring our SATP-Core repository to follow IETF 
> recommendations and guidelines for managing drafts in Github (following 
> i-d-template [2]). Thanks Yaron for the help.
> 
> Our build and submission processes are now automated. You can access 
> the latest version of the core draft (Editor's Copy) and respective 
> diff against the latest published draft (Datatracker). See more here in 
> the SATP core repo [3].
> 
> Contributing to the Core draft is much easier, since the draft is now 
> in markdown format. One can now fork the repo, make changes to the 
> draft, and submit a PR. The branch from the PR will get compiled, 
> making the assessment of changes seamless. You can check detailed 
> instructions to contribute here [4].
> 
> I encourage the authors of the other drafts to setup up their 
> repositories [5] with this method. Please let me know if you have any 
> questions or need assistance.
> 
> P.S., the latest version of the crash recovery draft is available here 
> [6].
> 
> Cheers,
> --
> -- Rafael Belchior
> 
> Ph.D. student in Computer Science and Engineering, Blockchain - Técnico
> Lisboa
> https://rafaelapb.github.io/
> https://www.linkedin.com/in/rafaelpbelchior/-

-- 
-- Rafael Belchior

Ph.D. student in Computer Science and Engineering, Blockchain - Técnico 
Lisboa
https://rafaelapb.github.io/
https://www.linkedin.com/in/rafaelpbelchior/

Links:
------
[1] 
https://us-phishalarm-ewt.proofpoint.com/EWT/v1/PjiDSg!2U-hiJRVKlMa2u_bWCEPD5UxckTFAtTKhT_I8Y-S2IKKg14YsjRymP6kCfM7BIyi-8cy_8-LfCFGKJNrz7Gj8PQ4UGDjhruqJiJdizQ$
[2] https://github.com/martinthomson/i-d-template
[3] https://github.com/ietf-satp/draft-ietf-satp-core
[4] 
https://github.com/ietf-satp/draft-ietf-satp-core/blob/main/CONTRIBUTING.md
[5] https://github.com/orgs/ietf-satp/repositories
[6] https://github.com/ietf-satp/draft-belchior-satp-gateway-recovery