Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1m6gyF-0001Bf-Bp for pgsql-docs@arkaria.postgresql.org; Thu, 22 Jul 2021 22:15:11 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1m6gyE-0005Gq-8L for pgsql-docs@arkaria.postgresql.org; Thu, 22 Jul 2021 22:15:10 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1m6gyD-0005Gh-Ie for pgsql-docs@lists.postgresql.org; Thu, 22 Jul 2021 22:15:10 +0000 Received: from out3-smtp.messagingengine.com ([66.111.4.27]) by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1m6gyB-0003dj-4d for pgsql-docs@lists.postgresql.org; Thu, 22 Jul 2021 22:15:08 +0000 Received: from compute6.internal (compute6.nyi.internal [10.202.2.46]) by mailout.nyi.internal (Postfix) with ESMTP id 28DC15C00E9; Thu, 22 Jul 2021 18:15:05 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute6.internal (MEProxy); Thu, 22 Jul 2021 18:15:05 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; bh=7+VOuTdqR4uon0tGO1W8K8D0G7tk9davihSDvkWs7Mo=; b=kfGppKHq mcCVHiSR4+X7oCQ1904M4pnCMbzcCvw6vLnTv3S5jhV2abdwYQqn/5ao9ULYuwgv nYd5ZNidvOzA8TlysPOgTF1kAHozmKCCe871NKlATN0ITCaCTlYmUOlcXRLijZgF HH6un+EduVQhqQf+pMsk4UsyrJW3VMygIRZy1AWy1/cr21e9kUtTbs+ywcnb80Zt teyklAkaGbNcZtJLCVKuqqw6+Acz+csEvIJ+B7i8zoq2yVS7VHKsc1bETGhaA2Y+ 0EXv39Fcdcc2w7viD2zp2cxBgxFBCELZSsaoXe9PPSsbVVmDX81zviNKwpMS/RP7 KcVYzcoNj0Co4A== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvtddrfeejgddtgecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpeffhffvuffkgggtugfgjgesthekredttddtjeenucfhrhhomheptehlvhgrrhho ucfjvghrrhgvrhgruceorghlvhhhvghrrhgvsegrlhhvhhdrnhhoqdhiphdrohhrgheqne cuggftrfgrthhtvghrnhepudejveejffejveduudetvdekieeuiedtvdeileefkeevjedu feeguedvjefhueelnecuffhomhgrihhnpegvnhhtvghrphhrihhsvggusgdrtghomhenuc evlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegrlhhvhhgv rhhrvgesrghlvhhhrdhnohdqihhprdhorhhg X-ME-Proxy: Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 22 Jul 2021 18:15:03 -0400 (EDT) Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000) id A835C2A09B6; Thu, 22 Jul 2021 18:14:58 -0400 (-04) Date: Thu, 22 Jul 2021 18:14:58 -0400 From: Alvaro Herrera To: Tom Lane Cc: Peter Eisentraut , "Jonathan S. Katz" , "Daniel Westermann (DWE)" , "pgsql-docs@lists.postgresql.org" Subject: Re: Link t the souce code Message-ID: <202107222214.g5temkz6grtt@alvherre.pgsql> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: <716628.1626893498@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk On 2021-Jul-21, Tom Lane wrote: > Alvaro Herrera writes: > > Well, we can remove that first paragraph from there and just refer the > > reader to the appendix ... something like this, perhaps. > > +1, though I think you're short a or so. Two markup errors actually, and there were a couple of other typos too. > Agreed that we're not here to teach people how to use git. But it'd > be worth explaining our branch naming conventions in that appendix. > It'd be sufficient I guess to mention "master" and "REL_n_STABLE"; > by the time v15 sees the light of day, all the pre-v10 branches > will be EOL. (Maybe also explain the REL_m_n release tags?) I'll leave that for another day. -- Álvaro Herrera Valdivia, Chile — https://www.EnterpriseDB.com/ "Sallah, I said NO camels! That's FIVE camels; can't you count?" (Indiana Jones)