Re: Additional Chapter for Tutorial

From: Erik Rijkers <er(at)xs4all(dot)nl>
To: Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Additional Chapter for Tutorial
Date: 2020-10-30 16:45:00
Message-ID: f13dcc2a57d4ce05ce1e83aa2f94396e@xs4all.nl
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On 2020-10-30 11:57, Jürgen Purtz wrote:
> On 26.10.20 15:53, David G. Johnston wrote:
>> Removing -docs as moderation won’t let me cross-post.
>>

Hi,

I applied 0009-architecture-vs-master.patch to head
and went through architecture.sgml (only that file),
then produced the attached .diff

And I wrote down some separate items:

1.
'Two Phase Locking' and 'TPL' should be, I think,
'Two-Phase Commit'. Please someone confirm.
(no changes made)

2.
To compare xid to sequence because they similarly 'count up' seems a bad
idea.
(I don't think it's always true in the case of sequences)
(no changes made)

3.
'accesses' seems a somewhat strange word most of the time just 'access'
may be better. Not sure - native speaker wanted. (no changes made)

4.
'heap', in postgres, means often (always?) files. But more generally,
the meaning is more associated with memory. Therefore it would be good
I think to explicitly use 'heap file' at least in the beginning once to
make clear that heap implies 'safely written away to disk'. Again, I'm
not quite sure if my understanding is correct - I have made no changes
in this regard.

Erik Rijkers

Attachment Content-Type Size
architecture.sgml.20201030.diff text/x-diff 20.4 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2020-10-30 18:33:10 127.0.0.1 or localhost
Previous Message Tom Lane 2020-10-30 15:09:58 Re: Missing file is mentioned on page https://www.postgresql.org/docs/13/libpq-exec.html

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2020-10-30 16:48:24 Re: document pg_settings view doesn't display custom options
Previous Message Heikki Linnakangas 2020-10-30 16:41:41 Re: Parallel copy