Date: Thu, 6 May 2021 17:53:36 -0400
From: Alvaro Herrera <alvherre@alvh.no-ip.org>
To: "Daniel Westermann (DWE)" <daniel.westermann@dbi-services.com>
Cc: "pgsql-docs@lists.postgresql.org" <pgsql-docs@lists.postgresql.org>
Subject: Re: Link t the souce code
Message-ID: <20210506215336.GA15748@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="bp/iNruPH9dso1Pn"
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: 
 <GV0P278MB04835AAEACF894617574EB6BD25A9@GV0P278MB0483.CHEP278.PROD.OUTLOOK.COM>
User-Agent: Mutt/1.10.1 (2018-07-13)
Archived-At: 
 <https://www.postgresql.org/message-id/20210506215336.GA15748%40alvherre.pgsql>
Precedence: bulk


--bp/iNruPH9dso1Pn
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit

Hello

On 2021-May-04, Daniel Westermann (DWE) wrote:

> reading this: https://www.postgresql.org/docs/13/install-getsource.html
> ...
> I wonder if the link should not directly point to the relevant release, e.g.:
> https://www.postgresql.org/ftp/source/v13.2/
> 
> To me that seems to be more convenient than figuring that out on
> https://www.postgresql.org/download/. The initial page is about
> getting the source code, so links to packages/binaries are not
> required if someone is looking for the source. 

I agree -- if the user wanted packages, they would not be reading that
page of the docs.  I'd just have it point to the same page that the
download page points to for source downloads, not a version-specific
one, as in the attached patch.

How does it look?

-- 
Álvaro Herrera                            39°49'30"S 73°17'W

--bp/iNruPH9dso1Pn
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="download-source.patch"

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml
index 50d9fa2021..c972f07405 100644
--- a/doc/src/sgml/installation.sgml
+++ b/doc/src/sgml/installation.sgml
@@ -347,7 +347,7 @@ su - postgres
   <para>
    The <productname>PostgreSQL</productname> &version; sources can be obtained from the
    download section of our
-   website: <ulink url="https://www.postgresql.org/download/"></ulink>.  You
+   website: <ulink url="https://www.postgresql.org/ftp/source/"></ulink>.  You
    should get a file named <filename>postgresql-&version;.tar.gz</filename>
    or <filename>postgresql-&version;.tar.bz2</filename>. After
    you have obtained the file, unpack it:

--bp/iNruPH9dso1Pn--