Re: [Rfc-markdown] 1.3.34: map most codeblock classes to <sourcecode> instead of <artwork>

Carsten Bormann <cabo@tzi.org> Mon, 22 February 2021 00:38 UTC

Return-Path: <cabo@tzi.org>
X-Original-To: rfc-markdown@ietfa.amsl.com
Delivered-To: rfc-markdown@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id EA7F93A08C5; Sun, 21 Feb 2021 16:38:28 -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, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 2DxDe7GmkUPY; Sun, 21 Feb 2021 16:38:26 -0800 (PST)
Received: from gabriel-vm-2.zfn.uni-bremen.de (gabriel-vm-2.zfn.uni-bremen.de [134.102.50.17]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A706F3A08C0; Sun, 21 Feb 2021 16:38:23 -0800 (PST)
Received: from [192.168.217.152] (p5089a828.dip0.t-ipconnect.de [80.137.168.40]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-vm-2.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4DkNZh0qp8zyhT; Mon, 22 Feb 2021 01:38:20 +0100 (CET)
Content-Type: multipart/alternative; boundary="Apple-Mail=_44A0C4B6-DA27-49D7-82A3-EFC7840B498F"
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.60.0.2.21\))
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <E9362A07-0057-4DF0-B006-C45149F0FC82@ietf.org>
Date: Mon, 22 Feb 2021 01:38:19 +0100
Cc: Julian Reschke <julian.reschke@gmx.de>, rfc-markdown@ietf.org, RFC Interest Group <rfc-interest@rfc-editor.org>
Message-Id: <DA36EA61-F136-4C9F-9FA2-B9CBC24A6D7F@tzi.org>
References: <4E1735EC-A5DD-4201-A6EA-2285D5CC9C21@tzi.org> <20210219072402.GA151175@miek.nl> <77684aa0-dcdb-fc38-8d31-86f2f5ae2ede@gmx.de> <22FFC094-63C4-43E8-8FDA-28832DD7FF28@tzi.org> <B8D57CFC-EB4A-4F7E-8614-99F39719183A@tzi.org> <E9362A07-0057-4DF0-B006-C45149F0FC82@ietf.org>
To: Jay Daley <jay@ietf.org>
X-Mailer: Apple Mail (2.3654.60.0.2.21)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rfc-markdown/1Q-3LEXqH2qK-RFNLK48qVM0ZYs>
Subject: Re: [Rfc-markdown] 1.3.34: map most codeblock classes to <sourcecode> instead of <artwork>
X-BeenThere: rfc-markdown@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "rfc-markdown is a discussion list for people writing I-Ds and RFCs in Markdown and the authors of the tools used for that." <rfc-markdown.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rfc-markdown/>
List-Post: <mailto:rfc-markdown@ietf.org>
List-Help: <mailto:rfc-markdown-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rfc-markdown>, <mailto:rfc-markdown-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 22 Feb 2021 00:38:29 -0000

>> Sorry, my intent here is probably better visible in the current editor’s version:
>> 
>> https://cabo.github.io/mtct/draft-bormann-core-media-content-type-format.html <https://cabo.github.io/mtct/draft-bormann-core-media-content-type-format.html>
> 
> I’m not sure I understand - do you mean that you want it indented to show that you are quoting the ABNF or do mean that you want a different alignment.  I ask because I can’t see a different alignment.

I was essentially trying to separate the ABNF quoted for reference from the ABNF that is part of this specification.
As you can see, this doesn’t work very well in the HTML (better for figure 1, where it is obvious this is centred, than for figure 4).
The distinction is much easier to see in the plaintext, where aside/blockquote get much stronger visual support.

So this may not be the perfect example, but it was a case where I was trying to center source code.

My criticism of the current grammar is that there are lots of arbitrary differences between different contexts in which things can be used, and these arbitrary differences seem to be driven by the combination of (1) a desire to enforce a weird perception of “good style” with (2) a lack of imagination.  Much less of this would probably have happened if the grammar had been properly factorized.  The grammar style to repeat everything everywhere seems to suggest one should endlessly tweak any single one of the clones so they are all subtly different, leading to the current jungle.

CCing rfc-interest, because this is a problem not with, but for writing IETF documents in markdown.

Grüße, Carsten