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 1rehcY-00CvRK-7Z for pgsql-hackers@arkaria.postgresql.org; Mon, 26 Feb 2024 20:30:42 +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 1rehcW-00Gg4v-Px for pgsql-hackers@arkaria.postgresql.org; Mon, 26 Feb 2024 20:30:41 +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 1rehcW-00Gg4n-H0 for pgsql-hackers@lists.postgresql.org; Mon, 26 Feb 2024 20:30:41 +0000 Received: from sss.pgh.pa.us ([68.162.161.243]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1rehcU-001Fst-H7 for pgsql-hackers@postgresql.org; Mon, 26 Feb 2024 20:30:40 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.15.2/8.15.2) with ESMTP id 41QKUa8d1967820; Mon, 26 Feb 2024 15:30:36 -0500 From: Tom Lane To: Nathan Bossart cc: Andrew Atkinson , pgsql-hackers@postgresql.org, samay@tembo.io Subject: Re: An improved README experience for PostgreSQL In-reply-to: <20240226183018.GA2109010@nathanxps13> References: <20240226183018.GA2109010@nathanxps13> Comments: In-reply-to Nathan Bossart message dated "Mon, 26 Feb 2024 12:30:18 -0600" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <1967818.1708979436.1@sss.pgh.pa.us> Date: Mon, 26 Feb 2024 15:30:36 -0500 Message-ID: <1967819.1708979436@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk Nathan Bossart writes: > I think this would be nice. If the Markdown version is reasonably readable > as plain-text, maybe we could avoid maintaining two READMEs files, too. > But overall, +1 to modernizing the README a bit. Per past track record, we change the top-level README only once every three years or so, so I doubt it'd be too painful to maintain two versions of it. Having said that, any proposal for this ought to be submitted as a patch, rather than expecting people to go digging around on some other repo. regards, tom lane