Re: initdb - creating clusters - Mailing list pgsql-docs

From Daniel Gustafsson
Subject Re: initdb - creating clusters
Date
Msg-id 3166114A-AB6E-4216-B65B-2E51D41712AA@yesql.se
Whole thread Raw
In response to Re: initdb - creating clusters  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: initdb - creating clusters
List pgsql-docs
> On 30 Aug 2020, at 17:21, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>
> Thomas Munro <thomas.munro@gmail.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


pgsql-docs by date:

Previous
From: Jürgen Purtz
Date:
Subject: Re: Additional Chapter for Tutorial
Next
From: Tom Lane
Date:
Subject: Re: initdb - creating clusters