public inbox for [email protected]
help / color / mirror / Atom feedFrom: Magnus Hagander <[email protected]>
To: Tom Lane <[email protected]>
Cc: Maciek Sakrejda <[email protected]>
Cc: pgsql-docs <[email protected]>
Subject: Re: Getting Started section
Date: Fri, 4 Mar 2016 12:41:49 +0100
Message-ID: <CABUevEy59Du48Zzn=9_gj0U0sY7PnbbLzf5Neb9=_QvDmUWV8g@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <CAOtHd0DdB4QZy=VSw1fHm55NY1TEMxV6R4jAP9CkKhd17_GWBw@mail.gmail.com>
<[email protected]>
<CABUevEyqWPcLGVO8jhraZZwbyriT+Q2LjNKO7bpWXw+WyvRPKA@mail.gmail.com>
<[email protected]>
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>
On Wed, Mar 2, 2016 at 3:51 PM, Tom Lane <[email protected]> wrote:
> Magnus Hagander <[email protected]> writes:
> > On Wed, Mar 2, 2016 at 9:36 AM, Tom Lane <[email protected]> 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 ...
>
They have to be maintained *somewhere*. We could also ask the same people,
at least for the major platforms, to maintain it as part of our
documentation. Doing that would certainly make it easier for *new users*,
who are the target of this...
If not the whole docs, then we should at least include *exact* instructions
for where to find the platform specific docs for big platforms. As in
explicitly tell people where the doc files are located on debian, redhat,
etc.
--
Magnus Hagander
Me: http://www.hagander.net/
Work: http://www.redpill-linpro.com/
view thread (6+ messages)
reply
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: [email protected]
Cc: [email protected], [email protected], [email protected]
Subject: Re: Getting Started section
In-Reply-To: <CABUevEy59Du48Zzn=9_gj0U0sY7PnbbLzf5Neb9=_QvDmUWV8g@mail.gmail.com>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox