From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HTML_MESSAGE,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 7586 invoked from network); 19 May 2022 06:05:11 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 19 May 2022 06:05:11 -0000 ARC-Seal: i=2; cv=pass; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1652940311; b=ZMvDYN4Wj1nAug1+09ThxQAExmTpoFNNb/QepEVa+B+DRE2urGJ6vbMzpwOIqlKP+v1n400mM+ riGS3ZJ0SpAV7A07efpiAVh6Q13M8qolKYf8HmNp/Tq22eDHM9NT7mGGimDeBMmZnlo0zJd6ek aigItI6ML65k9FNKq2LB12DWTM0b6N2zWsJxfQwSB0iKIMH3poCfwYmxsMDtRNABpzc1Dke2VS FeD1AJ3qjDUvkFH/nZjDoV2j+izFf1O+ANTd4QjWgZQUL1hULPyei6s7H5J2CI9et/HYKhp6q7 UNK4tZ21c/luA++SF2bomDx8h7cVs36q0BHXx8u2MdLJow==; ARC-Authentication-Results: i=2; zsh.org; iprev=pass (mail-bmxind01on2056.outbound.protection.outlook.com) smtp.remote-ip=40.107.239.56; dkim=pass header.d=iisc.ac.in header.s=selector2 header.a=rsa-sha256; dmarc=pass header.from=iisc.ac.in; arc=pass (i=1) header.s=arcselector9901 arc.oldest-pass=1 smtp.remote-ip=40.107.239.56 ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1652940311; bh=U3HcDg/zWTCdRSvpkbKbf6We4ILBEBjT2vlQ8zfzWFQ=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:MIME-Version:Content-Type:In-Reply-To:References:Message-ID: Date:Subject:Cc:To:From:DKIM-Signature:DKIM-Signature; b=C6z0jhtec6VgxsL+NEkD3fz/Gnv8TK4OikxOxJ2vLWtJZPEV7bbZnMTEyy7Vs58AHPO9XuDIpT iakumI2MqpbgfTeIbwR2nSSH+Y/esu/6EG/Y+aY791ZEas8M3R56i67LajlZ4TCrcI4VeTJr+T wM1qymasCDirMfPJQP9wkJYWWUAJVx8PbXq9BHegGuqxbsHJM8Vozu63hjv3Pp1fJuZo1ccRMT JYtI9BRKEK7aS1ZAMIzTqzO4Ad4rykZoiQ5EHlPPqNdmtVRUOtB1oz0iDfAAnwz0eO9c0GvuxT VUDdECiy1MdFLS71u4+V5a6uSCDbQjQhYmewZLuY/GAU1Q==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20210803; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:MIME-Version:Content-Type:In-Reply-To :References:Message-ID:Date:Subject:CC:To:From:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=N4Kkm/bV2udAis9f27HbCbFMCjtJS05n1QW1P2XOEn4=; b=gZ7cAwlrxKquQrjKbGDzYkv+52 XwiHXL2diHDFbaLx1GLd+iduDjrlcR1cgag00EDy+sI0erI4qvnaXouzTgjKhqRVX+tdZImP4vc4l O1yheCEHnQsWswESOYh+UpObcBEb7bM4Bqi4z6hHEnpIHK3KWNTlXz4CD0AEzZ5S2TPzoTbgGOtO4 09VMkZQh2So728fAYS4mybTLNCzJNqqUZn8pJoGl4fhHieO5+1nFgMKPECR7Kj92O9N9jXFwjsIdX nQwZL4rtz+RQZSCPlkmPCr3iqRbqy4pQHOHENqMuOtQJrrpjyGUzPcQJ8iL0V39xoWf+shsDA0CUF 5xKd/vxA==; Received: from authenticated user by zero.zsh.org with local id 1nrZHa-000HvF-Sf; Thu, 19 May 2022 06:05:10 +0000 Authentication-Results: zsh.org; iprev=pass (mail-bmxind01on2056.outbound.protection.outlook.com) smtp.remote-ip=40.107.239.56; dkim=pass header.d=iisc.ac.in header.s=selector2 header.a=rsa-sha256; dmarc=pass header.from=iisc.ac.in; arc=pass (i=1) header.s=arcselector9901 arc.oldest-pass=1 smtp.remote-ip=40.107.239.56 Received: from mail-bmxind01on2056.outbound.protection.outlook.com ([40.107.239.56]:19801 helo=IND01-BMX-obe.outbound.protection.outlook.com) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1nrZGy-000HaR-Ou; Thu, 19 May 2022 06:04:33 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=g9xTxCEa4raoBZKu401yYXIZFR20iYmpjosjTrL6hloaYb3gWQooj6rwNGz0ri/W0TFVIgyApfRjgnV1RiTD4pdY4DK7cXJg+8pkWqmOdLIbcTLMRpDIz0v4kM3vI3fD37N1/g93VCG/dEd9tTprvIOg4kxLKkYVR/wdGrR9dJQJeEMP/wjI8edU4Le0X/yNPiem4WoeSevdXIiFxbXKqzL+ysM1O4r7LTm840b146YV0W4FSjYdImNoqiyWafUVE6NiFBqqZgZ1kCHosJ+vzTf+TqYnjxGp4c737WIcqIhXA1cRXptnFHqo6on1wlLu59T9Eql0YJ7zpBjoj+zVDg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=N4Kkm/bV2udAis9f27HbCbFMCjtJS05n1QW1P2XOEn4=; b=b1F+MjbCdK567wX0PX3NWnJz9DFDIpEpMKVxvT31R6V2+4+szG2/Rzrt4MLIzM8e3E3xYBaaFFkHdb7EaqVnDTOw67I8dfseJV990OaDXqEYQMXhz21nY20sVu9vXSQIAkQZfSiiltdCYcAYpkjtZcASQssDwp8nxkxCdvZkSzDVTrEOI3jGQcGsUS+SujJpIFxRYT/kfc2Ku77QsvvoLb7Kze+azHYhiBZoHBUegAOiuIJHz0kbzOY5ErDzUClEGyFL3He3GeZyxQ6evnB70W1NeDzn87Nhh6a5+LwT6MgBlbK20GpFJTaAQxQZ256l0R3zgiEwc7V20hrnDa0UvA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=iisc.ac.in; dmarc=pass action=none header.from=iisc.ac.in; dkim=pass header.d=iisc.ac.in; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=iisc.ac.in; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=N4Kkm/bV2udAis9f27HbCbFMCjtJS05n1QW1P2XOEn4=; b=M6bqAMMYx1Ap1Jubump57Go43i487reQK0CB8a8xZY0Og540imsK+dNB2HCb3LEtFBd4aXvWoiU9HwgKPS0PtSDil1FGprismW1pEm6ToKPzjYUxyh3PliFUCB7EJV4h1JbmxfIC5E88STSaaytIOzX0VeKxeWd2cy61h3HW8Q8= Received: from MA1PR01MB2876.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a00:37::22) by PNZPR01MB8169.INDPRD01.PROD.OUTLOOK.COM (2603:1096:c01:3c::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5273.15; Thu, 19 May 2022 06:04:28 +0000 Received: from MA1PR01MB2876.INDPRD01.PROD.OUTLOOK.COM ([fe80::1101:393c:d1fc:c91e]) by MA1PR01MB2876.INDPRD01.PROD.OUTLOOK.COM ([fe80::1101:393c:d1fc:c91e%7]) with mapi id 15.20.5250.018; Thu, 19 May 2022 06:04:28 +0000 From: Bevan Stanely To: =?iso-8859-1?Q?Lawrence_Vel=E1zquez?= , dana CC: "zsh-workers@zsh.org" Subject: Re: Proposal: Use Markdown syntax for README and other documentation Thread-Topic: Proposal: Use Markdown syntax for README and other documentation Thread-Index: AQHYaswvrDc5gotHKk2fQmCGrdWamq0lZLoAgAAwMYCAAAbYgIAAGk72 Date: Thu, 19 May 2022 06:04:28 +0000 Message-ID: References: <33e425a1-36a6-4fa6-8a59-a892a7861d93@www.fastmail.com> In-Reply-To: Accept-Language: en-IN, en-US Content-Language: en-IN X-MS-Has-Attach: X-MS-TNEF-Correlator: msip_labels: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=iisc.ac.in; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: bcc9f6a3-9403-4fd1-e655-08da395d6f24 x-ms-traffictypediagnostic: PNZPR01MB8169:EE_ x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: O4PIbXGodZ8GvjkRzjgBgExhWFybpkLazjcrhRyO7ndIMeXu+gRuOxM3o0kEbNrYcwZ9l0akeUIB6IZmoLKcXbhCWH8ch+QwEWGglY5hhPImncx/7/h65eifcxDywsOf7Z5RZMGZgDa6NgiXd6LTdprQSI8f2dZTW/48ZpaRIW+DSUlvRPcKgUyDKLcxEmsckCizEhpjUexQt91q3k4C0JL/QYDP8QFV9cyLTZl50T3n3H0+8EAcqWtXMFDTaptnzV0kMLj1e8lavc69yHWLdMoc5BHBFvZGJKFtv2IcK6cXW4yvI9/Vk5zKg5CAkHTjeyXNRM8kjVu8m8MpRwMH2CS+tXE6wPasmQYJTMrTN+IdFujztGA9g1hskpS/Okimo/ahrjeYBQizq3rYv7myyyRisEz8/N34mMMjyhGVpasbtGT/neo7gCpLq9tDC3Z1cCuUeG+8YoA74uI6LbCfQ0lxE555V2Jh/ebVdJ7PYdnIHs7jwDH+xxMdATA0eKUWzbN37KfqqcQFdpq55wPMaSSREuNHF3BiZB2WzvcjNbx1i+aEY78WXh8ttoSTFNE4AI2DtSCT+UKHZnOr3x3Ug8UTv95GQs7fSWFLaDNKJ7O0nmJ6SfDEmpTS02H+Z7yQLS8ZVpVs94Ol4p3/31RP+6A2Q4co2895FijGcWeaSQOMOpXCUCsm/lbBS+s7Rs4/C32xHLZBAM0jqg96xH7hl076HgzlffhFQ3NBvnS4dNLi6w+yC3D3BxwKgABJ9NDQrhHqgBTFqfRntmNTqi9vZIZ0M5/eaHEDrq4Ze3mFhlY= x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:MA1PR01MB2876.INDPRD01.PROD.OUTLOOK.COM;PTR:;CAT:NONE;SFS:(13230001)(4636009)(366004)(38070700005)(2906002)(38100700002)(508600001)(966005)(86362001)(71200400001)(786003)(316002)(166002)(110136005)(5660300002)(52536014)(8936002)(76116006)(91956017)(64756008)(66446008)(8676002)(4326008)(66946007)(122000001)(66476007)(66556008)(83380400001)(19627405001)(33656002)(6506007)(53546011)(26005)(55016003)(9686003)(66574015)(186003)(7696005);DIR:OUT;SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?iso-8859-1?Q?BUhT+73YYIaRgtem2LkSdobBPyCgNtL+ssky51pTNda77vH9NDINSRROql?= =?iso-8859-1?Q?H4bM8T0Zo5/+FO21+8i7AxYVbVpO4DpNo9uPhfvUlHtpsmn58Nllr0BK8v?= =?iso-8859-1?Q?Yq39DIA1fmGb2L0Zw6G8oX480xNpUwO6jk0OLo4ji3wx9Y1kU8rVCIjHlc?= =?iso-8859-1?Q?TAsw6gTGzf8PvhvOrTZZsp2nXV/AwzYRDMI3zlKGPkBw1fkpUyxRnXhgAy?= =?iso-8859-1?Q?NTF8uVn2t0cXfymuN96ocx+mEvEWP6nooyACU3hewYJzRv7OEJFNrZGU0l?= =?iso-8859-1?Q?iqr7T7Vu3xbtAKCZfnXcLAnmzau7keU0MIkyo+rmk+PjjLGdYs9JlrZtaW?= =?iso-8859-1?Q?EU3V2xqBGcuA3ur+n1Elx7ybb5sWRZe7oreK09prCmnraiFpULHm/vMcr3?= =?iso-8859-1?Q?3LmdbiO60xH0PF1hMhwllDEysKCEn58L3U4rQ3swBildm/aQn+Spp9mUUO?= =?iso-8859-1?Q?KL+lb3bSHLbgb9YbNv92OcD8U/phZQskIYw/7lJyNdl8bYWBXNsKHEClBl?= =?iso-8859-1?Q?6wxW2Cu4aRkOYjZ1ZGKI3watW2cJTxa8BuN74BFFQgxoxgcMdQ/MSvtiAA?= =?iso-8859-1?Q?oBPe//vxMQ9CYfxaOSy7eEESxxUqGiyRYr28Kl0XTlID5LsYzLbwQlX6QD?= =?iso-8859-1?Q?m6PbjcQ+RzAJsSbYyhScXpqjffBEj3/oudw3i6V/Ogjds18V34QLoe+0Mq?= =?iso-8859-1?Q?S5ZrakO3x99oQ+z6vWRhZklHyUxZX5TbpXrSZP3Ny/uB0fqc+Q5Y3I+xM3?= =?iso-8859-1?Q?waDUt+999pbraDjbvbYBB2xwjGm1u4IfYi4D5DewryUOtIhdZaXALq9Mc+?= =?iso-8859-1?Q?EfKU8rZLc79bPcmjr5MUr3rp3Bm0HGG9oKn6qgC9ojcSXwyXNo5cRkzaZ6?= =?iso-8859-1?Q?3VxNBSt1Vyz4aqNS4B8f9ZTddcuaptdUggg+jiBgiNT74Ab6bSf0ij5jKQ?= =?iso-8859-1?Q?XAKGWVU5vajKl5INVGNvJavzEtdE3OPeL+j+sLWFfpyEHr4bQO1SfLEm8N?= =?iso-8859-1?Q?OtUSYwD9GAA1eIOkeM3KJHhTZ7e03XeXcOWlX3DZo6wUtdB/XrEcwI0y/7?= =?iso-8859-1?Q?Z/hJsAr0nVT18LE2qKAB8SZUbWo6YSkSHt+mHCbHHDnWBc9M6YOgo3w6i7?= =?iso-8859-1?Q?2r03LYn9jLJZMrlqJv/r2Xt+sP2X1UVqntP/3SkJmdDgl1J8i0dVBcCtj/?= =?iso-8859-1?Q?eNF/C7UEeszmIlWsdYDfF2VuocP5IHz1iJpbbPS3PAnk3HafV4Y7UYCgyL?= =?iso-8859-1?Q?0S5QsFqYTAUwObyTjaQLzcIoPZVZBRaeKpyFRNVpAbPiSLtJMsEIwk7IiY?= =?iso-8859-1?Q?I6QKFvOgLBGFtBk48vakxTYMcam/3fRsXNsJ4frQAwhCl4+FKBmPsw7qh4?= =?iso-8859-1?Q?/S3svD/aZpBgMf8pVXRbtTQ7lw8DVPZ4jA0EyidfMRdvgEtcAlmYxzKRKA?= =?iso-8859-1?Q?2Nku82KoD9dlg08tePkKNY2P8sJ8oJsY97yYlVut4VWQcq5lfVyt8xuNDB?= =?iso-8859-1?Q?5vp2Zc1KCl7znQcQl0uKE/iJWFyyAtzjLdaXfHjT5J61A1LoPtJ74t9HVW?= =?iso-8859-1?Q?ntcdu5hmBf5Xe1AoBjL4oId92jnuLnY1T9gOHp9sHbL5Lp33/dKdlrwiWW?= =?iso-8859-1?Q?TT71W1c3Bm/5GDIt4CWhwQTHkqFLpJe60ab3dMJkRQSiiGqPOhuF2/1bXi?= =?iso-8859-1?Q?dJRRbinwEX183L/TKTA/cbEqTn/cdjTuSTodHFtfXUkZqAQjnh3HMh/AXZ?= =?iso-8859-1?Q?jhaWrWQWSFXBLhPEWbMnq25xt4yn6QvxMiDzeGgLnrGADxYFTNrJVc0pjf?= =?iso-8859-1?Q?z/lATNpwjA=3D=3D?= Content-Type: multipart/alternative; boundary="_000_MA1PR01MB2876DDD7729194C2BF9B7F8AE9D09MA1PR01MB2876INDP_" MIME-Version: 1.0 X-OriginatorOrg: iisc.ac.in X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: MA1PR01MB2876.INDPRD01.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-Network-Message-Id: bcc9f6a3-9403-4fd1-e655-08da395d6f24 X-MS-Exchange-CrossTenant-originalarrivaltime: 19 May 2022 06:04:28.5152 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 6f15cd97-f6a7-41e3-b2c5-ad4193976476 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: Uwb6IYo8QYkzODyFxfGfnFub//VQ8J0WLjm1iMVyr/DX4jziGlASy9k/DuUmubyK9ZptLvv6IWlT9reEN9QuUQ== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PNZPR01MB8169 X-Seq: 50250 Archived-At: X-Loop: zsh-workers@zsh.org Errors-To: zsh-workers-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-workers-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: --_000_MA1PR01MB2876DDD7729194C2BF9B7F8AE9D09MA1PR01MB2876INDP_ Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable This is the git tree of my commit in Sourceforge before I removed the raw H= TML according to vq's opinion. It renders it fine. The only issue was the f= ile extension. I understand the reasons for dreading any markup, it's just = a proposal anyway if it's too inconvenient we can always drop the idea. https://sourceforge.net/p/zsh-fork/code/ci/a205af4809fbe2335438e6b83c1b55bd= abba5504/tree/ ________________________________ From: Lawrence Vel=E1zquez Sent: 19 May 2022 09:56 To: dana Cc: zsh-workers@zsh.org ; Bevan Stanely Subject: Re: Proposal: Use Markdown syntax for README and other documentati= on External Email On Thu, May 19, 2022, at 12:02 AM, dana wrote: > On Wed 18 May 2022, at 20:10, Lawrence Vel=E1zquez wrote: >> While nice for editing, raw markup (even Markdown) makes for a poor >> reading experience. > > I don't think that's necessarily the case, as demonstrated by the fact > that Bevan thought we were already using Markdown lol. And we very nearly > are I agree that Markdown is not bad if limited to the quieter markup (e.g., headings, strong, emphasis, lists, blockquotes, etc.). Those also tend to be decently portable between implementations. The problem is that it's always tempting to move on to the less-quiet markup :-/ > I don't think it'd be a big change to have the README standardise on some > sub-set of Markdown to make it look a little nicer on code-hosting sites, > as long as we continued to avoid the more advanced/noisy features like > images and hyper-links The PR in question introduces both of those things, as well as raw HTML (which SourceForge would sanitize away) and backslash escaping. -- vq --_000_MA1PR01MB2876DDD7729194C2BF9B7F8AE9D09MA1PR01MB2876INDP_ Content-Type: text/html; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable
This is the git tree of my commit in Sourceforge before I removed the raw H= TML according to vq's opinion. It renders it fine. The only issue was the f= ile extension. I understand the reasons for dreading any markup, it's just = a proposal anyway if it's too inconvenient we can always drop the idea.

From: Lawrence Vel=E1zquez = <larryv@zsh.org>
Sent: 19 May 2022 09:56
To: dana <dana@dana.is>
Cc: zsh-workers@zsh.org <zsh-workers@zsh.org>; Bevan Stanely &= lt;bevanstanely@iisc.ac.in>
Subject: Re: Proposal: Use Markdown syntax for README and other docu= mentation
 
External Email


On Thu, May 19, 2022, at 12:02 AM, dana wrote:
> On Wed 18 May 2022, at 20:10, Lawrence Vel=E1zquez wrote:
>> While nice for editing, raw markup (even Markdown) makes for a poo= r
>> reading experience.
>
> I don't think that's necessarily the case, as demonstrated by the fact=
> that Bevan thought we were already using Markdown lol. And we very nea= rly
> are

I agree that Markdown is not bad if limited to the quieter markup
(e.g., headings, strong, emphasis, lists, blockquotes, etc.).  Those also tend to be decently portable between implementations.

The problem is that it's always tempting to move on to the less-quiet
markup :-/

> I don't think it'd be a big change to have the README standardise on s= ome
> sub-set of Markdown to make it look a little nicer on code-hosting sit= es,
> as long as we continued to avoid the more advanced/noisy features like=
> images and hyper-links

The PR in question introduces both of those things, as well as raw
HTML (which SourceForge would sanitize away) and backslash escaping.

--
vq
--_000_MA1PR01MB2876DDD7729194C2BF9B7F8AE9D09MA1PR01MB2876INDP_--