RE: document writing/editing tools used by IETF

Larry Masinter <LMM@acm.org> Fri, 26 February 2021 02:06 UTC

Return-Path: <masinter@gmail.com>
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 35D913A15B9 for <ietf@ietfa.amsl.com>; Thu, 25 Feb 2021 18:06:40 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.499
X-Spam-Level:
X-Spam-Status: No, score=-6.499 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, RCVD_IN_DNSWL_HI=-5, 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 (2048-bit key) header.d=gmail.com
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 xi_bx3khA9Mf for <ietf@ietfa.amsl.com>; Thu, 25 Feb 2021 18:06:38 -0800 (PST)
Received: from mail-pj1-x102d.google.com (mail-pj1-x102d.google.com [IPv6:2607:f8b0:4864:20::102d]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 88FB43A1647 for <ietf@ietf.org>; Thu, 25 Feb 2021 18:06:30 -0800 (PST)
Received: by mail-pj1-x102d.google.com with SMTP id jx13so1613076pjb.1 for <ietf@ietf.org>; Thu, 25 Feb 2021 18:06:30 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:references:in-reply-to:subject:date:message-id :mime-version:content-transfer-encoding:content-language :thread-index; bh=cZEQAeOdhWb50k0d+FUHCByf9sfJ8sEGT3B0RCioryQ=; b=eCFXXSJqUTC/SuvLt0OfPfSz/CQsi0lFr7u3gSdhVIIpyN7b/hfLjNgkR58tGOSpqK CMlcdeLk8hxnSifBP2httSkSegI+tax+Cel94XjhvuaooyeE7wqa4rD1IiBhQ/czhGVY /sFlLllYh1vkSvXdpj+U8euouOawXrFz58o7gI6z00xvn71snVgMysx6PMjv2JHpfrr2 Y1iXsKaa713itp8yVrDQRtcxJwPoqZcRDncoExhpbpp+vngvTyRE5ObJmb1ZN7PsBeb+ JpwAOoc4YU9QMd2emXh6+pEKOqKlAH2PWY5zw1Abpq2ZTVS+1WFrSopzXKjdwxbGcJvQ OpZA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:references:in-reply-to:subject :date:message-id:mime-version:content-transfer-encoding :content-language:thread-index; bh=cZEQAeOdhWb50k0d+FUHCByf9sfJ8sEGT3B0RCioryQ=; b=aZwuHwDpeZhY/6mFsbqdmNR6urh8TM5GxWLmB2e1szm3qFRN1/9tHh9GsQw8Fw3r4n BhyeFw8Y3Cra77h+kSZbWB5ntBG0qwGFMLvlpGjifbNrgjamMyteu5haqY9dX+70VBDc PVg/B14ncCVIfTUvK7ip6eS96hSmGSdpDgel4+KVbXQMSuc+HzC51jujdEEDAr2o7omt h6l4zqlr8ThXX7LUx695cWNhNau1hlg+rW+KGIjAhmEB6k4avsxnJqfjF/RnTGuvnjlx i2ZztE/uJDJG4DCRtFw36YdPvUZIA9oobdYg8sx83z171Oh0nAh2i7K+rdoPQqHZvzX1 /QWw==
X-Gm-Message-State: AOAM530wafsVDYkxY2iKTxk+IQLMKRuY/Bhp5hI74JwqVg7rDsNu1cy/ ZT5pn2d9hvKFGuW5Qef/h/mKwm+IYuo=
X-Google-Smtp-Source: ABdhPJwINzuPypvBWgXvNCtA1FSTbZ4gDe13DSJZ9OUKcA1JD0Qv3h7CfCcddIZcaUhQ2CKwHN/j4A==
X-Received: by 2002:a17:902:e80e:b029:e3:cc4a:549c with SMTP id u14-20020a170902e80eb02900e3cc4a549cmr955370plg.82.1614305189695; Thu, 25 Feb 2021 18:06:29 -0800 (PST)
Received: from TVPC (c-73-158-116-21.hsd1.ca.comcast.net. [73.158.116.21]) by smtp.gmail.com with ESMTPSA id h3sm7263854pgm.67.2021.02.25.18.06.28 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 25 Feb 2021 18:06:29 -0800 (PST)
Sender: Larry Masinter <masinter@gmail.com>
From: Larry Masinter <LMM@acm.org>
X-Google-Original-From: "Larry Masinter" <lmm@acm.org>
To: "'Carsten Bormann'" <cabo@tzi.org>, "'Keith Moore'" <moore@network-heretics.com>
Cc: <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>
In-Reply-To: <37142313-C251-40DC-9336-D3A2F0FB69AD@tzi.org>
Subject: RE: document writing/editing tools used by IETF
Date: Thu, 25 Feb 2021 18:06:28 -0800
Message-ID: <001d01d70be3$ff0972d0$fd1c5870$@acm.org>
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: quoted-printable
X-Mailer: Microsoft Outlook 16.0
Content-Language: en-us
Thread-Index: AQLT1bdL7pqR2nvaftdkRCfHM2U8nwKGphCgAhOj+SoBLW9aDwGyzqaoAugWWj4CTmHmY6gKkcWQ
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/YbI3vT2XLSNTiFMUlPQ4SIfy_HU>
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 02:06:46 -0000

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.

I'd suggest, though, starting with a conservative rule: any Internet Draft may be SUBMITTED in any of the RFC OUTPUT formats: XML2RFC, plain text, simple HTML, PDF. ("simple HTML" needs definition but it isn't hard).

You can use whatever collaborative tool you want, though you might have to do a conversion, but that's true for Markdown and GitHub use.    And every one of the collaborative document tools offer at least one of those formats.
--
https://LarryMasinter.net https://interlisp.org

> -----Original Message-----
> From: ietf <ietf-bounces@ietf.org> On Behalf Of Carsten Bormann
> Sent: Thursday, February 25, 2021 5:19 PM
> To: Keith Moore <moore@network-heretics.com>
> Cc: ietf@ietf.org
> Subject: Re: document writing/editing tools used by IETF
> 
> On 25. Feb 2021, at 21:27, Keith Moore <moore@network-heretics.com>
> wrote:
> >
> > I would like to make it be the case that anyone could submit a document
> written with their favorite word processor, and for that document to be
> converted to whatever format we want to use.   I actually think this is
> feasible for document submission.
> 
> This works if the draft is written by a single person.
> This approach does not lend itself to cooperative editing, for many reasons.
> 
> Grüße, Carsten