Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1rfPHO-00HUJX-7I for pgsql-hackers@arkaria.postgresql.org; Wed, 28 Feb 2024 19:07:47 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1rfPHM-00EBNp-Rl for pgsql-hackers@arkaria.postgresql.org; Wed, 28 Feb 2024 19:07:45 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1rfPHM-00EBNh-Ex for pgsql-hackers@lists.postgresql.org; Wed, 28 Feb 2024 19:07:45 +0000 Received: from smtp.outgoing.loopia.se ([93.188.3.37]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1rfPHK-001qIL-K6 for pgsql-hackers@postgresql.org; Wed, 28 Feb 2024 19:07:44 +0000 Received: from s807.loopia.se (localhost [127.0.0.1]) by s807.loopia.se (Postfix) with ESMTP id 8EBB72FFA3AB for ; Wed, 28 Feb 2024 20:07:41 +0100 (CET) Received: from s899.loopia.se (unknown [172.22.191.5]) by s807.loopia.se (Postfix) with ESMTP id 7CD092E2D9C3; Wed, 28 Feb 2024 20:07:41 +0100 (CET) Received: from s473.loopia.se (unknown [172.22.191.5]) by s899.loopia.se (Postfix) with ESMTP id 796892C8BA98; Wed, 28 Feb 2024 20:07:41 +0100 (CET) X-Virus-Scanned: amavisd-new at amavis.loopia.se X-Spam-Flag: NO X-Spam-Score: -1.21 X-Spam-Level: X-Spam-Status: No, score=-1.21 tagged_above=-999 required=6.2 tests=[ALL_TRUSTED=-1, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, T_SCC_BODY_TEXT_LINE=-0.01] autolearn=disabled Authentication-Results: s473.loopia.se (amavisd-new); dkim=pass (2048-bit key) header.d=yesql.se Received: from s979.loopia.se ([172.22.191.6]) by s473.loopia.se (s473.loopia.se [172.22.190.13]) (amavisd-new, port 10024) with LMTP id H8Z1PD0R5zKY; Wed, 28 Feb 2024 20:07:41 +0100 (CET) X-Loopia-Auth: user X-Loopia-User: daniel@yesql.se X-Loopia-Originating-IP: 89.255.232.193 Received: from smtpclient.apple (customer-89-255-232-193.stosn.net [89.255.232.193]) (Authenticated sender: daniel@yesql.se) by s979.loopia.se (Postfix) with ESMTPSA id CB57810BC3B1; Wed, 28 Feb 2024 20:07:40 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yesql.se; s=loopiadkim1707475645; t=1709147260; bh=PkDNGB0zHGrZzdIoMBqUNa+iPNXCZPysgQfbqf0UJJ8=; h=From:Subject:Date:References:Cc:In-Reply-To:To; b=lz7FbV9kizW605rewPN2KED+w/RWk/W4jjtqtB0z3CB7TTgRWcYHbtrAt1XmmY1sL PP5xGJIiTY4GJpTTvS/jJxhvLB47FAuKMEGbWWe68/pn+gB3O0fE9+gyBmSJ2yZuBB VBxktHu6I9nzCEMmKuv3o1k90SsIRE9Jsl9K+rcsbmnDELK5DxAbYEfbUPMbmiEgNJ yTNPtc7UvuCPZXDi8NTf0VL6aJgMHtMT2Y351xXG02g7X4kFjHGf5ISMqIJ7uj88Gb gOh3GBlqEfkkGXlCfOQupzysuJ6rHDjX3/4LK5WSU1DKgDoO/1JCVMjj53VXOe5PpZ LoI0uQeWvBV3w== Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable From: Daniel Gustafsson Mime-Version: 1.0 (1.0) Subject: Re: An improved README experience for PostgreSQL Date: Wed, 28 Feb 2024 20:07:30 +0100 Message-Id: References: <202402281851.37k26w47cced@alvherre.pgsql> Cc: Joe Conway , Nathan Bossart , Tom Lane , Andrew Atkinson , PostgreSQL Hackers , samay@tembo.io In-Reply-To: <202402281851.37k26w47cced@alvherre.pgsql> To: Alvaro Herrera X-Mailer: iPhone Mail (20H307) List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk > On 28 Feb 2024, at 19:51, Alvaro Herrera wrote: >=20 > =EF=BB=BFOn 2024-Feb-28, Joe Conway wrote: >=20 >> Markdown is pretty readable as text, I'm not sure why we need both. >=20 > *IF* people don't go overboard, yes. I agree, but let's keep an eye so > that it doesn't become an unreadable mess. I've seen some really > horrible markdown files that I'm sure most of you would object to. Absolutely, I agree. Considering the lengths we go to to keep our code reada= ble I=E2=80=99m not worried, I expect that a markdown README would end up pr= etty close to the txt version we have today. ./daniel=