document writing/editing tools used by IETF

Keith Moore <moore@network-heretics.com> Thu, 25 February 2021 20:27 UTC

Return-Path: <moore@network-heretics.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 E58143A0928 for <ietf@ietfa.amsl.com>; Thu, 25 Feb 2021 12:27:11 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.896
X-Spam-Level:
X-Spam-Status: No, score=-1.896 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_NONE=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=messagingengine.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 xJ8Psff70ZSP for <ietf@ietfa.amsl.com>; Thu, 25 Feb 2021 12:27:10 -0800 (PST)
Received: from out3-smtp.messagingengine.com (out3-smtp.messagingengine.com [66.111.4.27]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id E76703A0935 for <ietf@ietf.org>; Thu, 25 Feb 2021 12:27:08 -0800 (PST)
Received: from compute2.internal (compute2.nyi.internal [10.202.2.42]) by mailout.nyi.internal (Postfix) with ESMTP id 208355C0125 for <ietf@ietf.org>; Thu, 25 Feb 2021 15:27:08 -0500 (EST)
Received: from mailfrontend2 ([10.202.2.163]) by compute2.internal (MEProxy); Thu, 25 Feb 2021 15:27:08 -0500
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm2; bh=KOIC/n1vC21UKQfmnwjMgcba0aTfZFXIOyF1HAm2+ 6A=; b=ieuCLDg42KcjbMBOMXZz1c8tli57MOUn8TLN/XraXbFaWLBzD/X8mfmGg RCDgF0fpa7+aaxiNK/4p5oedNW/Gnbh2FuTzzt1Jw6ma4p4OVoeXRw4iqalByZe+ CqZncsoAxCWh6JLiQLGt+N9xfQs5vwmQSq2OBQ0mKUN/XmbHZ33hSxvvAd6D77kK c+E9KBFpIDfflz/JdmcHuZcn+NnYgFq80tjxL7pQeyyJEnewKSuzLQqEQ41DIJ/1 7XZB8MlZeopDO698OTaKah2w+of/wI3JLVUrTV0QoNCzjfDfUIyFDJgOoqDgnC9A kh3+PfrwU9NUprNbp3BabqnxcWMgQ==
X-ME-Sender: <xms:Gwg4YK6P9QPH3wDXe0zXjwRYsOtpX4JWYZcnWW48pzl6H4wb93fEbg> <xme:Gwg4YPYTH0o7L5azvwMMZszarY0nB5g1P6DZ3HMG3Il2xm7BJ-nNtuOZmnGLvchBP jm03QKjBG6Hig>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduledrkeelgddugedtucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpefuvfhfhffkffgfgggjtgfgsehtke ertddtfeejnecuhfhrohhmpefmvghithhhucfoohhorhgvuceomhhoohhrvgesnhgvthif ohhrkhdqhhgvrhgvthhitghsrdgtohhmqeenucggtffrrghtthgvrhhnpeehhfeutdehfe fgfefghfekhefguefgieduueegjeekfeelleeuieffteefueduueenucfkphepuddtkedr vddvuddrudektddrudehnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrg hilhhfrhhomhepmhhoohhrvgesnhgvthifohhrkhdqhhgvrhgvthhitghsrdgtohhm
X-ME-Proxy: <xmx:Gwg4YP6tk7vbQexfsKTFhicfPVWSGvIXm4j2VRQJ8BeVPEBcnGxzQA> <xmx:Gwg4YCAGcWseJ9x6TvCQbkQqC_v-uMWdI5FDnWtmHz7vz05S1UsxUw> <xmx:Gwg4YFe1HLQYOANdlXX2_l8vCXvzpDiMieYPBNoVkf4DgBXJRkG7kw> <xmx:HAg4YDjHdrL_Awzgw1ozSvk1pJTrP32eyWP2wLz_o9CgX5YRG_h9ZA>
Received: from [192.168.1.90] (108-221-180-15.lightspeed.knvltn.sbcglobal.net [108.221.180.15]) by mail.messagingengine.com (Postfix) with ESMTPA id C2C1C1080068 for <ietf@ietf.org>; Thu, 25 Feb 2021 15:27:07 -0500 (EST)
Subject: 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>
From: Keith Moore <moore@network-heretics.com>
Message-ID: <089096b1-10d2-3eac-d37c-f040a1930061@network-heretics.com>
Date: Thu, 25 Feb 2021 15:27:06 -0500
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0
MIME-Version: 1.0
In-Reply-To: <LO2P265MB057322BA95B1B44D4175356BC29E9@LO2P265MB0573.GBRP265.PROD.OUTLOOK.COM>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/AHekD9XQ8uvvyh_vGAkkt_sLUos>
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: Thu, 25 Feb 2021 20:27:18 -0000

On 2/25/21 12:39 PM, Andrew Campling wrote:

> This made me smile as GitHub is itself an excellent example of a tool being a barrier to entry for new participants.
+1.
> I've been using word processors since the early '80s (WordStar back in the day), don't understand why anyone would opt to use a different tool to write a document.

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.   If nothing else, most word 
processors can generate some flavor of HTML, and that HTML could be 
stripped down to its bare essence and converted to rfc2xml.   It's 
entirely doable, probably with a relatively small amount of python 
code.   (You do need some conventions for representing metadata in HTML 
that can be input with a word processor, but I think I see how to do 
that too.)

But if we insist on one particular word processor, that will create a 
huge mess.   Having multiple parties edit the same document in 
succession with different tools (even if they're supposedly all 
compatible with the same format) results in a document that some people 
won't be able to read or edit, won't display or print consistently, 
etc., and may not be repairable.     And all of those document formats 
are moving targets.

> I know that this point of view will not be accepted by many current IETF participants but it seems particularly perverse to use a software development tool to write documents when there are many widely available options that are far better suited to the task (many of which support collaborative writing).

Actually, I doubt there is a single option that is better and which 
supports collaborative writing.  Because forcing thousands of volunteers 
to use a common set of proprietary tools (many of which are unreliable, 
profoundly dysfunctional, expensive, and have abysmal user interfaces) 
is absolutely unacceptable.

Keith