Re: Add A Glossary

From: Corey Huinker <corey(dot)huinker(at)gmail(dot)com>
To: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
Cc: Jürgen Purtz <juergen(at)purtz(dot)de>, Roger Harkavy <rogerharkavy(at)gmail(dot)com>, pgsql-hackers(at)postgresql(dot)org, Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>, Michael Paquier <michael(at)paquier(dot)xyz>
Subject: Re: Add A Glossary
Date: 2020-03-20 01:41:54
Message-ID: CADkLM=edwjdfMCoCMxHDrXfX_UW0TdPuyvRO=wFqaddxER4cTQ@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Thu, Mar 19, 2020 at 8:11 PM Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
wrote:

> I gave this a look. I first reformatted it so I could read it; that's
> 0001. Second I changed all the long <link> items into <xref>s, which
>

Thanks! I didn't know about xrefs, that is a big improvement.

> are shorter and don't have to repeat the title of the refered to page.
> (Of course, this changes the link to be in the same style as every other
> link in our documentation; some people don't like it. But it's our
> style.)
>
> There are some mistakes. "Tupple" is most glaring one -- not just the
> typo but also the fact that it goes to sql-revoke. A few definitions
> we'll want to modify. Nothing too big. In general I like this work and
> I think we should have it in pg13.
>
> Please bikeshed the definition of your favorite term, and suggest what
> other terms to add. No pointing out of mere typos yet, please.
>

Jürgen mentioned off-list that the man page doesn't build. I was going to
look into that, but if anyone has more familiarity with that, I'm listening.

> I think we should have the terms Consistency, Isolation, Durability.
>

+1

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Corey Huinker 2020-03-20 15:48:24 Re: Add A Glossary
Previous Message Alvaro Herrera 2020-03-20 00:11:22 Re: Add A Glossary

Browse pgsql-hackers by date

  From Date Subject
Next Message Andres Freund 2020-03-20 01:59:08 Re: Missing errcode() in ereport
Previous Message James Coleman 2020-03-20 01:38:46 Re: improve transparency of bitmap-only heap scans