Re: [Tools-arch] Document Production Methods

Martin Thomson <mt@lowentropy.net> Wed, 02 September 2020 03:57 UTC

Return-Path: <mt@lowentropy.net>
X-Original-To: tools-arch@ietfa.amsl.com
Delivered-To: tools-arch@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id DB3F93A0AF9 for <tools-arch@ietfa.amsl.com>; Tue, 1 Sep 2020 20:57:41 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=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=lowentropy.net header.b=r1uwnfDm; dkim=pass (2048-bit key) header.d=messagingengine.com header.b=cNcVodSz
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 WcE05DYtfOLi for <tools-arch@ietfa.amsl.com>; Tue, 1 Sep 2020 20:57:40 -0700 (PDT)
Received: from out1-smtp.messagingengine.com (out1-smtp.messagingengine.com [66.111.4.25]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id AC6E53A0AF8 for <tools-arch@ietf.org>; Tue, 1 Sep 2020 20:57:40 -0700 (PDT)
Received: from compute2.internal (compute2.nyi.internal [10.202.2.42]) by mailout.nyi.internal (Postfix) with ESMTP id 0372C5C01F1; Tue, 1 Sep 2020 23:57:40 -0400 (EDT)
Received: from imap10 ([10.202.2.60]) by compute2.internal (MEProxy); Tue, 01 Sep 2020 23:57:40 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lowentropy.net; h=mime-version:message-id:in-reply-to:references:date:from:to :subject:content-type; s=fm3; bh=z+/VCUSMIRbyiN3Kaq5EM+0rMOllqOu pGJO9+0CzJqc=; b=r1uwnfDmfcOiz/svR93Jj3wysIVIcZAzDWqWoED/s3M0yaU atGgoowpxBWPndD4dRKMeKohk5iwYESFie2G3MQeCjInAr2dcZB1Z1xd/xj4Z4ka rh5o5eS/wMrVAKAVXE3II+3B2oggWM7/69PbJTc6EaiHIwDwqP+EgJ+gl2ko0PZL MW/vHaDnOY3agjcPqiKgk1tHoEJXFXdtjK6ZST4vkrzgOclyI+LZwK8E9rqzvthj oeELmh+ADR10ERnsLmALeMRsqgyCMtViJaPzkukCP9E+SSkUtrTZlYFcrNjBzg71 lWTMjG1/ll4SEFiziy2ZI9fohWGxpr0L5IruPoA==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=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=fm3; bh=z+/VCU SMIRbyiN3Kaq5EM+0rMOllqOupGJO9+0CzJqc=; b=cNcVodSzvQoT30SqpqEvRn THf/NDYWiWXrXskAgoc9a58Y/IdkzBo14uJ83ztS4mhuc8UamAGB+24Wn8Wi8UAw NG/NpG/u6/PeuUpcBkD3YjmxMAm3OIN4M8nbRvEC/u9ZlShVGB/iflfNFR/3YrkK ViDOuAzhj4d2qtyLbUnRgPFcVXL3AL1hxVrfMd89WXLkoXijvRW2jxpsfDvLAHuH Be43frkXBOb9qGJkmhF0PCSvfwQFtiob0YlJOzie+JjBObg3GWel8jToIh/OwZw7 B21ZHpzX3fJunzCG4eDkIrqx7EgqiMA976bZh0OrEiSuiUEhsYU7JRZ06VYI+Jaw ==
X-ME-Sender: <xms:MxhPX9g5Vu2shRuXKMGqqw8SDY0whl8Tuwu087OJeX0KLLaYNHVyUA> <xme:MxhPXyDNxHC4YjiVXzg9LzLsr1NIpNb91NFhla5h-Oqpu3ItfIHsFJFDE0HimBqA1 U0gkW682TR-D3pL3g4>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduiedrudefkedgjeejucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhepofgfggfkjghffffhvffutgesthdtredtreertdenucfhrhhomhepfdforghr thhinhcuvfhhohhmshhonhdfuceomhhtsehlohifvghnthhrohhphidrnhgvtheqnecugg ftrfgrthhtvghrnhepkeetueeikedtkeelfeekvefhkeffvedvvefgkefgleeugfdvjeej geffieegtdejnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrh homhepmhhtsehlohifvghnthhrohhphidrnhgvth
X-ME-Proxy: <xmx:MxhPX9Fu9qSiWOMcAbqIVqILqq2FnsdGYdSaxnViq0TDp00fIIkKpg> <xmx:MxhPXyRhDFAthOl1V0Lxn4cniX5tA56LlbP3xLfFK4nrWeE-LdwlbA> <xmx:MxhPX6x4_zUqFLCUvK0UZt0Hr7UD8vsRpBdVyA5NI47E7dgNbokKpQ> <xmx:MxhPX_uDKbpedZOvw3dW7q6XxWbXNEg8-o3tW5qofKjglAQ_ZzAz3Q>
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 4785B20064; Tue, 1 Sep 2020 23:57:39 -0400 (EDT)
X-Mailer: MessagingEngine.com Webmail Interface
User-Agent: Cyrus-JMAP/3.3.0-248-gcd102cb-fm-20200901.001-gcd102cb9
Mime-Version: 1.0
Message-Id: <88deacab-2966-4a7f-a28f-b7c19abe3a2f@www.fastmail.com>
In-Reply-To: <20200902023617.66BA41F5F442@ary.qy>
References: <20200902023617.66BA41F5F442@ary.qy>
Date: Wed, 02 Sep 2020 13:57:14 +1000
From: Martin Thomson <mt@lowentropy.net>
To: John R Levine <johnl@taugh.com>, tools-arch@ietf.org
Content-Type: text/plain
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-arch/3s3IfzvqRauzPbIngFbcwRCfrs8>
Subject: Re: [Tools-arch] Document Production Methods
X-BeenThere: tools-arch@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Tools Architecture and Strategy Team <tools-arch.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-arch>, <mailto:tools-arch-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-arch/>
List-Post: <mailto:tools-arch@ietf.org>
List-Help: <mailto:tools-arch-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-arch>, <mailto:tools-arch-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 02 Sep 2020 03:57:42 -0000


On Wed, Sep 2, 2020, at 12:36, John Levine wrote:
> I think we underestimated how hard it is to do automated typsetting
> that produces good looking results so we ended up with a whole lot of
> very complex tagging to let people say in great detail how they want
> things to look. We also put in a lot of semantic tags, e.g., this is a
> picture, that is sourcecode, this other thing is someone's name, which
> may be useful for future automated processing but we don't know yet.

I guess what I'm challenging here is the inherent value of those annotations.

For the typesetting stuff, as that is tied to a very specific instance, attempting to preserve those as text is subsequently changed might be counterproductive.

For the semantic stuff, as they are not the product of any negotiation/consensus process, it is unlikely that they have any special status.  As such, I suggest that they exist on much the same level as other unofficial markings.  Useful or not, they aren't representative of the artifact we are looking to preserve.  They are only useful to the extent that they allow us to better communicate about that artifact, to which you next point might be the most salient in this regard...

> One of the few things that XML makes simple is to tell what is a tag
> and what is text.

That unfortunately isn't always respected, as I recently learned.  But that's a tooling issue that is easily rectified.