Re: Document NULL - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: Document NULL
Date
Msg-id CAKFQuwZ5=WYz0bLXj3ryqqecFvZRbxP20fo1GiDMFiqh-qODeg@mail.gmail.com
Whole thread Raw
In response to Re: Document NULL  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Document NULL
Re: Document NULL
Re: Document NULL
List pgsql-hackers
On Wed, May 1, 2024 at 9:47 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
David Rowley <dgrowleyml@gmail.com> writes:
> Let's bash it into shape a bit more before going any further on actual wording.

FWIW, I want to push back on the idea of making it a tutorial section.
I too considered that, but in the end I think it's a better idea to
put it into the "main" docs, for two reasons:


Version 2 attached.  Still a draft, focused on topic picking and overall structure.  Examples and links planned plus the usual semantic markup stuff.

I chose to add a new sect1 in the user guide (The SQL Language) chapter, "Data".  Don't tell Robert.

The "Data Basics" sub-section lets us readily slide this Chapter into the main flow and here the NULL discussion feels like a natural fit.  In hindsight, the lack of a Data chapter in a Database manual seems like an oversight.  One easily made because we assume if you are here you "know" what data is, but there is still stuff to be discussed, if nothing else to establish a common understanding between us and our users.

David J.


Attachment

pgsql-hackers by date:

Previous
From: Tomas Vondra
Date:
Subject: Parallel CREATE INDEX for GIN indexes
Next
From: "Imseih (AWS), Sami"
Date:
Subject: Re: New GUC autovacuum_max_threshold ?