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 1kFeaz-0007Gr-QZ for pgsql-docs@arkaria.postgresql.org; Tue, 08 Sep 2020 14:27:41 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1kFeay-0000rd-F1 for pgsql-docs@arkaria.postgresql.org; Tue, 08 Sep 2020 14:27:40 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kFeay-0000rW-9R for pgsql-docs@lists.postgresql.org; Tue, 08 Sep 2020 14:27:40 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kFeav-0007xM-En for pgsql-docs@lists.postgresql.org; Tue, 08 Sep 2020 14:27:39 +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 088ERXWv1764489; Tue, 8 Sep 2020 10:27:33 -0400 From: Tom Lane To: Magnus Hagander cc: "David G. Johnston" , Pg Docs Subject: Re: Installation instructions vs binaries In-reply-to: References: <1763586.1599573981@sss.pgh.pa.us> Comments: In-reply-to Magnus Hagander message dated "Tue, 08 Sep 2020 16:22:27 +0200" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <1764487.1599575253.1@sss.pgh.pa.us> Date: Tue, 08 Sep 2020 10:27:33 -0400 Message-ID: <1764488.1599575253@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk Magnus Hagander writes: > And I think Davids comment about repetitive language would apply to yours > as well, and should maybe be simplified there too? Per the discussion in the other thread, we concluded that being repetitive was the only way to be sure people would see the material at all. If you look at https://www.postgresql.org/docs/devel/runtime.html a lot of people are going to follow one of the section links before they ever see any of the chapter head material. (This would be less of a problem if we could get DocBook to insert the chapter TOC at the bottom of the page not the top. I dunno how to do that, though.) regards, tom lane