Re: document writing/editing tools used by IETF

Julian Reschke <julian.reschke@gmx.de> Fri, 26 February 2021 07:55 UTC

Return-Path: <julian.reschke@gmx.de>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 7F6E33A0BDF for <ietf@ietfa.amsl.com>; Thu, 25 Feb 2021 23:55:36 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
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, FREEMAIL_FROM=0.001, NICE_REPLY_A=-0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=gmx.net
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 N2TtIG1DlqEN for <ietf@ietfa.amsl.com>; Thu, 25 Feb 2021 23:55:34 -0800 (PST)
Received: from mout.gmx.net (mout.gmx.net [212.227.15.19]) (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 43E663A0BDE for <ietf@ietf.org>; Thu, 25 Feb 2021 23:55:27 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1614326123; bh=f1Nov+ApJ0vBuwzbz66/sLsgfd5eNW/k0AMQTkNq3zc=; h=X-UI-Sender-Class:Subject:To:References:From:Date:In-Reply-To; b=PazDHUmZCaRULDlFx1dfvNwO/f6icAdsJdxgYWLJ9FRzZO505tHpYkmkH+rbObX4T 752szfYfhBspMI0E3hAhtyuMycHLETtg9mwjpltm2eIzqMibBTudjvWYJ2HDpaMSTO UKz/jLEDF2BCc/gKi9HyBRUQ1A+/0SDi0oc08mfs=
X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c
Received: from [192.168.178.20] ([91.61.50.34]) by mail.gmx.net (mrgmx004 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MHXFr-1l2bX81vHt-00DZAr for <ietf@ietf.org>; Fri, 26 Feb 2021 08:55:23 +0100
Subject: Re: document writing/editing tools used by IETF
To: ietf@ietf.org
References: <37eecb9b-f0eb-e21c-b162-b1f0339e4981@si6networks.com> <3c2d646d-f18d-4d88-b458-29dbd486432b@beta.fastmail.com> <446A8D6B-E624-49E0-B67E-D1F8AFC794E2@lastpresslabel.com> <28ac1e86-f641-b9e8-0f61-6ff442feaa90@si6networks.com> <LO2P265MB057322BA95B1B44D4175356BC29E9@LO2P265MB0573.GBRP265.PROD.OUTLOOK.COM> <089096b1-10d2-3eac-d37c-f040a1930061@network-heretics.com> <37142313-C251-40DC-9336-D3A2F0FB69AD@tzi.org> <001d01d70be3$ff0972d0$fd1c5870$@acm.org> <CAMm+LwhkLTKkp3q4s97TBA-=WpJPof861mygPSjJttowpDjGuw@mail.gmail.com>
From: Julian Reschke <julian.reschke@gmx.de>
Message-ID: <8b42a18a-181e-cad7-7333-3e950e643665@gmx.de>
Date: Fri, 26 Feb 2021 08:55:22 +0100
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.8.0
MIME-Version: 1.0
In-Reply-To: <CAMm+LwhkLTKkp3q4s97TBA-=WpJPof861mygPSjJttowpDjGuw@mail.gmail.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: quoted-printable
X-Provags-ID: V03:K1:Eay3aQ0SSl+szPiroS3EudNCQ0leFL3ScIaNR5dexMm47Y9uZtl RqPOFQrWyS3rpy4r10vKQWFDQ8QW5uXkWx7FXZ8f4hB1QlTTeb64Y113RMdPoXOWAwO8vAb WA9i5DHtyiZIj/wfmvLdkfD0oV3me/M97R5X6zWboxapeIflgjYexuPoBEh4CjtN3i2V2p2 JCNVdP9jkom750SfUILRA==
X-UI-Out-Filterresults: notjunk:1;V03:K0:IzbD7KR4CJg=:khIe1BcZ+K292PdueWibkf raLQzhQ4qbIZVAGyzfI5/Fe3G5XfuH0WfWTwudcqgGfSAMyHJdbqjuaqFPIPAagr833b9bmbw Gy6Cz9g3Atb0zmqAYQs6rmgBm6G2GhZuZeIxpVTbrEifThSvUshd+jmBTUY5VzWSs++6CmIwl IG4oE/SrsUTTtByz9qb6kO83DD5U5GJYpxmZDPRsTPdPVLpbstfWi9cLfVGqZ4n7Ul9And2PV u0gmumgJnIPNgORyD36MAV+ybWWQf1uzGGw5hKtXSCXUeyX3M0dqCPU7c8janl6zNe6onzuDe QxHqAvqlbx3IEBrAscqXUioBUZ5/9DCAvSyLCnl049mCgGG1yrXuhLfUcYG24FAxB1VywMBYf WVYXCJ9BSHwmBFOzFCsWfHg8JThCq3nZiCyR36mw6FGBDzo+zBhZo7apcYn7EvyPeGzqjs+Od oJ23yxwrtN2x2Xw+6+ZVaXs5bUYPNzOdYIaE00YESGTlFJwv7LKAdNB/0xFsSt+2WbKKAPb5U 7B6UfUGiyl9BMUbagWOWpX+pRnyfXtFBpbKiDnOn5qKSsVHiCfu303hMxuYN/DyIAV2Mb/SdG g9RnsHstPzYSX3zzUsv3VuYPwIOE+wOHm2Rsw2A+o3Ww4inUzel8yD3+HBGeFSq/2HzU85LOT oN4hLKGGnUDse/BAo1Q4W/dbnoy7Ya6xh1Dya1v+svx3dZ/oXN/07Kahp6iRPmCz7Vh5RUm1V hcrLQFQQhau/t2x65PShHTGFizMK7KpHwWlBioIk29SbrBXNr8kcGZElbcle9G5SRE09GGJh1 WWPL3YNTcDWHoJziHAAaUSzHbqP7B/R6oOR/D10WVWPatInzPSk16rKEnsopSGTJveG1IWmop lRAKbD89EqZrCXDR87zg==
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/KUzSl89p4i9TIXeSe6gxWe_J35U>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 26 Feb 2021 07:55:43 -0000

Am 26.02.2021 um 04:18 schrieb Phillip Hallam-Baker:
> On Thu, Feb 25, 2021 at 9:08 PM Larry Masinter <LMM@acm.org
> <mailto:LMM@acm.org>> wrote:
>
>     Keith is talking about formats for submission. For collaboration,
>     there's a generation of collaborative tools from Google Docs to
>     Dropbox and Microsoft tools that are a lot better than GitHub for
>     collaboration.
>
>
> There only needs to be a single interface to the ID/RFC system.
>
> My model is to allow the authors to edit the drafts in Word/Markdown and
> create HTML output close to what the ID/RFC system produces. When they
> have agreed on an update, they send the .xml file to the submission system.
> ...

I'll +1 Carsten's "specs are code".

The huge benefit of a text-based, easily-diffable format is that you can
put it under source control, and then have tools that show who changed
what and when (and optimally why). For every single change, not just
between submitted IDs. For instance, for the HTTP core documents, that
history goes back to December 2007 (and it has survived conversion from
Subversion to Git).

If you can do that with Word, I'd definitively like to see that.

Best regards, Julian