Re: Getting Started section

From: Scott Marlowe <scott(dot)marlowe(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Magnus Hagander <magnus(at)hagander(dot)net>, Maciek Sakrejda <m(dot)sakrejda(at)gmail(dot)com>, pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Getting Started section
Date: 2016-03-02 16:07:42
Message-ID: CAOR=d=0=i6LoPJahH-i-pz3TDQXCd=1j+LpT-kBhkUKiUjwYUg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Wed, Mar 2, 2016 at 7:51 AM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> Magnus Hagander <magnus(at)hagander(dot)net> writes:
>> On Wed, Mar 2, 2016 at 9:36 AM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>>> Agreed, but I should think that properly packaged versions of Postgres
>>> will come with some package-specific instructions. Is that missing
>>> in Debian's version, or out of date, or did he just not read it?
>
>> It's definitely there for debian - it's in
>> /usr/share/doc/postgresql-common/README.Debian.gz
>
>> The bigger question is, is it worth actually more or less importing the
>> contents of that into our main documentation.
>
> I'm definitely -1 on that; there are too many distinct packagings and they
> change asynchronously to our releases. As a concrete example, the docs
> for Red Hat's version needed to change when they moved from SysV init
> scripts to systemd boot. Would we want to keep *both* versions of that
> in our manual, and explain exactly which RHEL/CentOS/Fedora versions the
> different texts applied to? No thanks ...

Would it be reasonable to just make it very clear the getting started
instructions are meant for install from source, and if you are using a
package, you should consult with your distribution?

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Magnus Hagander 2016-03-04 11:41:49 Re: Getting Started section
Previous Message Tom Lane 2016-03-02 14:51:11 Re: Getting Started section