Re: [EXTERNAL] Question about Codimd for w.g. minutes

Bob Hinden <bob.hinden@gmail.com> Thu, 29 July 2021 21:09 UTC

Return-Path: <bob.hinden@gmail.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 353623A03F1 for <wgchairs@ietfa.amsl.com>; Thu, 29 Jul 2021 14:09:07 -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, FREEMAIL_FROM=0.001, SPF_HELO_NONE=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=gmail.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 9rcxkQOuwt7c for <wgchairs@ietfa.amsl.com>; Thu, 29 Jul 2021 14:09:03 -0700 (PDT)
Received: from mail-wm1-x332.google.com (mail-wm1-x332.google.com [IPv6:2a00:1450:4864:20::332]) (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 ABE273A03AA for <wgchairs@ietf.org>; Thu, 29 Jul 2021 14:09:02 -0700 (PDT)
Received: by mail-wm1-x332.google.com with SMTP id h24-20020a1ccc180000b029022e0571d1a0so4927582wmb.5 for <wgchairs@ietf.org>; Thu, 29 Jul 2021 14:09:02 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:message-id:mime-version:subject:date:in-reply-to:cc:to :references; bh=hcE61M/rj9PvK7JZPU/pAF25p9OR3E0wmJ4QJQuGXT0=; b=tOLEpLX3CHu96zQzsrVgtvQ6nHjh9Me/pbdPy98US1YNYRROqLN1SUiPPzR4vUeGIo 3oPzoZnwpC4cqr3EwQNrMZGyxNmMNe+N1kAlqB3033da0IT9v9UYEAPFcYKSDXXuH8dq dTJwBPbRimFLzhxQwU95ZxgYmwC642tsJtmXcvYh3Au5O3HUss/xFsRMetB81Sc+r5+i LKdzvkm02AE2kilV4EJfyxHxJuS5MFyJt9uC9RIfd1W7BUGO8G/pLRlxK89CR/GgDhhR BF27itUZ0csPuUw5IRT40qKe+4RTnIRQsQrc4caietpUTN4x7CPTVbCnUSLS8dVjI9oq C4Qw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:message-id:mime-version:subject:date :in-reply-to:cc:to:references; bh=hcE61M/rj9PvK7JZPU/pAF25p9OR3E0wmJ4QJQuGXT0=; b=AUfpQ08VtD+gQ93xlPTil6ORR1fQVqx2jNpziYPF67o/6xACvV6nw3XU0kgnwBEBK4 MwFWyTChJpJ2QjyUAG1C/nhoxHfN7TBzqmB0fIlYSoj0GZj6fjyu6MGV98isM7+TEaZI 3M/jkTmz8bhgjsLfLeyQTcu5LcT7GjesHkE3d6TRlaW6lcQ6yt5cZ1uQWf8T/2Gq7tyM i1hq1RlEAYqXwsY4ZFH7AyEE6zDdA++pwwalqFDul+DRP9hP9CsDkPBa/EbGJw3Fk9Cm Hg/qbr36+7Y6ax56uF+5cXKf0ZxV+jeGEduxyppyu0IgTuVi2oTa1vBvXh8nYbHMDOmr 9WBg==
X-Gm-Message-State: AOAM533PdBESMxIUNlSYh0R/dI9ore0EXx7WEYN5kN+y68BbOzCAzMMY gl9XvHk02fshWqhnORylBpY=
X-Google-Smtp-Source: ABdhPJzS5Aw7cw4iHO0p/nUpvWyPm7ccGLrRQcinyV7jXdvBhpgvnDzfWgOV+Ni/+553SWZDB1HS/w==
X-Received: by 2002:a05:600c:190d:: with SMTP id j13mr340413wmq.127.1627592939992; Thu, 29 Jul 2021 14:08:59 -0700 (PDT)
Received: from [10.0.0.199] (c-73-223-183-113.hsd1.ca.comcast.net. [73.223.183.113]) by smtp.gmail.com with ESMTPSA id v2sm4585249wro.48.2021.07.29.14.08.58 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 29 Jul 2021 14:08:59 -0700 (PDT)
From: Bob Hinden <bob.hinden@gmail.com>
Message-Id: <23DF72E1-1759-4EB1-9577-016CDF703465@gmail.com>
Content-Type: multipart/signed; boundary="Apple-Mail=_B771F46E-2E4F-46CB-87A8-A21DF41DA587"; protocol="application/pgp-signature"; micalg=pgp-sha512
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.21\))
Subject: Re: [EXTERNAL] Question about Codimd for w.g. minutes
Date: Thu, 29 Jul 2021 14:08:55 -0700
In-Reply-To: <DM6PR02MB6924B0A8C7D7F2BE1F1A32FBC3EB9@DM6PR02MB6924.namprd02.prod.outlook.com>
Cc: Bob Hinden <bob.hinden@gmail.com>, Carsten Bormann <cabo@tzi.org>, Kyle Rose <krose@krose.org>, Working Group Chairs <wgchairs@ietf.org>
To: "STARK, BARBARA H" <bs7652@att.com>
References: <2A3CF02D-ACAC-440E-87FC-DD247C9DF0CA@gmail.com> <2B94E2D4-20E8-4E10-8A10-321F6E4C22FA@nbcuni.com> <8178CA4F-3AC1-4C01-91DF-B3864D23183F@gmail.com> <0D4DA368-BE52-4D51-986B-389CDDE7D680@nbcuni.com> <CAJU8_nWzmWiELMwme6P=r5DygZotEHAAP3A+HA3+SQLbd5DSMA@mail.gmail.com> <36687D77-F596-43A1-BD85-AC60B381BB3A@gmail.com> <62B18365-90F0-4773-8DEF-ABE9DE1A85F4@nbcuni.com> <CAJU8_nXevwOYaGvZdWWfEcKqNnfnHNzFK-PMv-PYTW-R8v12nw@mail.gmail.com> <528CDFDC-21B4-4BA1-8373-23744A460F6B@tzi.org> <DM6PR02MB6924B0A8C7D7F2BE1F1A32FBC3EB9@DM6PR02MB6924.namprd02.prod.outlook.com>
X-Mailer: Apple Mail (2.3445.104.21)
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/JYS7ydOfT2UwOVkWzIAV9xVd8Nc>
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: Thu, 29 Jul 2021 21:09:07 -0000

Barbara,

> On Jul 29, 2021, at 1:13 PM, STARK, BARBARA H <bs7652@att.com> wrote:
> 
>>> Interesting. I think CodiMD is rendering incorrectly, because markdown
>> intentionally ignores single newlines: if CodiMD wants a line break, it should
>> insert *two* newlines (a paragraph break) or two spaces at the end of a line
>> (line break) to get that effect. I would avoid the issue entirely by using bullets to
>> delineate elements.
>> 
>> That is a well-known problem with markdown:
>> Implementations differ in how "hard" newlines are.
>> (There is also a difference on where a bullet is recognized after a paragraph.)
>> 
>> CodiMD's markdown is very friendly to the online notes crowd.
>> Github flavored markdown (GFM) was until they reverted to Gruber's definition
>> of what a newline means.
>> Most other markdown implementations have the Gruber-like soft newlines and
>> "lazy" syntax that gives even less notice to newlines.
>> 
>> That's a bummer, indeed.
>> I'm not aware of a tool that converts hard-newline markdown like CodiMD's to
>> soft-newline ones (well, maybe kramdown can do that in its GFM mode; need to
>> check).
> 
> Right, CodiMD render markdown *differently* than datatracker. My strategy is to download the markdown to an Ubuntu laptop and edit using the Ubuntu Text Editor. I can also copy/paste from CodiMD into Text Editor. Text Editor is fabulous in its ability to recognize markdown and save as markdown.
> 
> The main edit I do is to put blank lines between all paragraphs. Then I upload the .md file to datatracker.
> 
> Really, I suspect at least one of your 2 notetakers was either too lazy to insert those extra blank lines while typing or didn't want to impact the experience of people who might be following the discussion using the rendered CodiMD notes (because the additional blank lines create blank lines in the CodiMD rendering). I had an eerily similar experience with DNSSD WG. But adding those blank lines before uploading to datatracker is simple -- if using the Ubuntu Text Editor. There may be other such magical editors, but I don't know about them.

That about what I ended up doing too.  A little painful, but not too bad.

Bob



> Barbara
>