Re: Please look at your groups' charters rendered through markdown

Robert Sparks <rjsparks@nostrum.com> Mon, 20 September 2021 19:29 UTC

Return-Path: <rjsparks@nostrum.com>
X-Original-To: wgchairs@ietfa.amsl.com
Delivered-To: wgchairs@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8897E3A0A1F for <wgchairs@ietfa.amsl.com>; Mon, 20 Sep 2021 12:29:55 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.08
X-Spam-Level:
X-Spam-Status: No, score=-2.08 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, NICE_REPLY_A=-0.001, T_SPF_HELO_PERMERROR=0.01, T_SPF_PERMERROR=0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=nostrum.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 nxO_HsB1G6Rt for <wgchairs@ietfa.amsl.com>; Mon, 20 Sep 2021 12:29:51 -0700 (PDT)
Received: from nostrum.com (raven-v6.nostrum.com [IPv6:2001:470:d:1130::1]) (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 4EF9F3A0A1D for <wgchairs@ietf.org>; Mon, 20 Sep 2021 12:29:51 -0700 (PDT)
Received: from unformal.localdomain ([47.186.34.206]) (authenticated bits=0) by nostrum.com (8.17.1/8.16.1) with ESMTPSA id 18KJTiTd063627 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NO); Mon, 20 Sep 2021 14:29:45 -0500 (CDT) (envelope-from rjsparks@nostrum.com)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=nostrum.com; s=default; t=1632166185; bh=jDakf6bRboYEuGC6v3uydGjXak6vhfHf6YWQeqVt0fA=; h=To:Cc:References:From:Subject:Date:In-Reply-To; b=KB0iXq5qM9NDGMRGncDSHJhH1odZKRWVYYRPlyAaEEcAB179+6PY6c3gepZgltcO3 Af90JxPBeHozHzmXNCh3o1IsLvJ8KdAcKrlP95r7Wus+6iFv6eX8KOoO869Bs9gO5O bANOaDXkZV16JB5x2wHFzUOima/WLwL8aRJZ0/xU=
X-Authentication-Warning: raven.nostrum.com: Host [47.186.34.206] claimed to be unformal.localdomain
To: Lars Eggert <lars@eggert.org>
Cc: Working Chairs <wgchairs@ietf.org>
References: <91a7eae6-6752-9c25-648a-69c4b75d600b@nostrum.com> <C7840DDC-D58F-4509-8E35-C260C6B327F3@eggert.org>
From: Robert Sparks <rjsparks@nostrum.com>
Subject: Re: Please look at your groups' charters rendered through markdown
Message-ID: <4b587a46-6443-a4b1-d532-a47fbc86b39a@nostrum.com>
Date: Mon, 20 Sep 2021 14:29:38 -0500
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:78.0) Gecko/20100101 Thunderbird/78.14.0
MIME-Version: 1.0
In-Reply-To: <C7840DDC-D58F-4509-8E35-C260C6B327F3@eggert.org>
Content-Type: text/plain; charset="windows-1252"; format="flowed"
Content-Transfer-Encoding: quoted-printable
Content-Language: en-US
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/b2xuZ2gd9YSG6SqGjvpoc865V5Y>
X-BeenThere: wgchairs@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Working Group Chairs <wgchairs.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/wgchairs/>
List-Post: <mailto:wgchairs@ietf.org>
List-Help: <mailto:wgchairs-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 20 Sep 2021 19:29:56 -0000

And here we hit the issues with the different versions of markdown at 
different sites.

Github markdown treats leading space differently than Gruber's markdown.

The relevant part of the source for the thing ending up with a different 
rendering looks like this (via hexdump -C). Best viewed in fixed width.

00000100  6c 65 64 20 62 65 6c 6f  77 3a 0a 0a 20 20 20 31  |led 
below:..   1|
00000110  2e 20 54 68 65 20 66 69  72 73 74 20 61 72 65 61  |. The first 
area|
00000120  20 6f 66 20 77 6f 72 6b  20 69 73 20 6d 61 69 6e  | of work is 
main|
00000130  74 65 6e 61 6e 63 65 20  61 6e 64 20 65 76 6f 6c |tenance and 
evol|
00000140  75 74 69 6f 6e 20 6f 66  20 74 68 65 20 65 78 69 |ution of the 
exi|
00000150  73 74 69 6e 67 20 51 55  49 43 20 73 70 65 63 69 |sting QUIC 
speci|
00000160  66 69 63 61 74 69 6f 6e  73 3a 0a 0a 20 20 20 20 
|fications:..    |
00000170  20 20 20 20 20 2a 20 4d  61 69 6e 74 65 6e 61 6e |     * 
Maintenan|
00000180  63 65 20 61 6e 64 20 65  76 6f 6c 75 74 69 6f 6e  |ce and 
evolution|
00000190  20 6f 66 20 74 68 65 20  51 55 49 43 20 62 61 73  | of the 
QUIC bas|
000001a0  65 20 73 70 65 63 69 66  69 63 61 74 69 6f 6e 73  |e 
specifications|

That is, there are 9 spaces before what you intend to be a bullet mark.

For what's at https://pypi.org/project/Markdown/ (implementing 
https://daringfireball.net/projects/markdown/), anything that starts 
with 4 or more spaces or a tab is a blockquote.

Do you easily see a single input file that gets the desired output out 
of both renderers?

RjS

On 9/20/21 2:17 PM, Lars Eggert wrote:
> On 2021-9-20, at 20:34, Robert Sparks <rjsparks@nostrum.com> wrote:
>> Bring any issues with the markdown rendering of the current charter text to me.
> Not my group anymore, but QUIC looks a bit odd: https://datatracker.ietf.org/group/quic/about/rendertest/
>
> That should be an indented bullet list under 1., as shown on https://github.com/quicwg/wg-materials/blob/main/charter/charter.md
>
> Thanks,
> Lars
>