Re: [rfc-i] [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: <rfc-interest-bounces@rfc-editor.org>
X-Original-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Delivered-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4FD9B3A08C5; Sun, 21 Feb 2021 16:38:35 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.647
X-Spam-Level:
X-Spam-Status: No, score=-2.647 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HEADER_FROM_DIFFERENT_DOMAINS=0.25, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=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 u-xIfpPXTkJ7; Sun, 21 Feb 2021 16:38:33 -0800 (PST)
Received: from rfc-editor.org (rfc-editor.org [4.31.198.49]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 643B13A08E4; Sun, 21 Feb 2021 16:38:33 -0800 (PST)
Received: from rfcpa.amsl.com (localhost [IPv6:::1]) by rfc-editor.org (Postfix) with ESMTP id 191DFF40718; Sun, 21 Feb 2021 16:38:26 -0800 (PST)
X-Original-To: rfc-interest@rfc-editor.org
Delivered-To: rfc-interest@rfc-editor.org
Received: from localhost (localhost [127.0.0.1]) by rfc-editor.org (Postfix) with ESMTP id 3C913F40718 for <rfc-interest@rfc-editor.org>; Sun, 21 Feb 2021 16:38:24 -0800 (PST)
X-Virus-Scanned: amavisd-new at rfc-editor.org
Received: from rfc-editor.org ([127.0.0.1]) by localhost (rfcpa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id oUHMmdRIHzwE for <rfc-interest@rfc-editor.org>; Sun, 21 Feb 2021 16:38:20 -0800 (PST)
Received: from gabriel-vm-2.zfn.uni-bremen.de (gabriel-vm-2.zfn.uni-bremen.de [134.102.50.17]) by rfc-editor.org (Postfix) with ESMTPS id 31DCBF40710 for <rfc-interest@rfc-editor.org>; Sun, 21 Feb 2021 16:38:20 -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)
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
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)
Subject: Re: [rfc-i] [Rfc-markdown] 1.3.34: map most codeblock classes to <sourcecode> instead of <artwork>
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://www.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <http://www.rfc-editor.org/pipermail/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://www.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
Cc: Julian Reschke <julian.reschke@gmx.de>, rfc-markdown@ietf.org, RFC Interest Group <rfc-interest@rfc-editor.org>
Content-Type: multipart/mixed; boundary="===============2245386859288926537=="
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>

>> 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

_______________________________________________
rfc-interest mailing list
rfc-interest@rfc-editor.org
https://www.rfc-editor.org/mailman/listinfo/rfc-interest