Re: initdb - creating clusters

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Thomas Munro <thomas(dot)munro(at)gmail(dot)com>, Bruce Momjian <bruce(at)momjian(dot)us>, gazzatav(at)gmail(dot)com, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: initdb - creating clusters
Date: 2020-09-02 13:02:00
Message-ID: 3166114A-AB6E-4216-B65B-2E51D41712AA@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 30 Aug 2020, at 17:21, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>
> Thomas Munro <thomas(dot)munro(at)gmail(dot)com> writes:
>> + The discussions in this chapter assume that you are working with
>> + an unmodified version of <productname>PostgreSQL</productname>,
>> + for example one that you built from source according to the directions
>> + in the preceding chapters. If you are working with a pre-packaged
>
>> Rather than "unmodified", would it be better to say something more
>> like "without any extra supporting infrastructure"?
>
> So maybe "... you are working with plain
> <productname>PostgreSQL</productname> without any additional
> infrastructure, for example a copy that you built from source
> according to the directions in the preceding chapters." ?

That seems pretty clearly worded to me.

> Do you have a feeling one way or the other about whether to repeat
> some of this text in each of the relevant sub-sections? I initially
> didn't want to do that, but thinking about how people consume the
> HTML docs, I'm afraid that anything not appearing on the same page
> won't get seen.

I think you're right here, duplicating the content is probably required for it
to be useful.

cheers ./daniel

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2020-09-02 16:43:18 Re: initdb - creating clusters
Previous Message Jürgen Purtz 2020-09-02 07:04:38 Re: Additional Chapter for Tutorial