Re: documentation structure - Mailing list pgsql-hackers

From Peter Eisentraut
Subject Re: documentation structure
Date
Msg-id 7698f0d0-28a1-4f0c-a326-3d1e7d98dd95@eisentraut.org
Whole thread Raw
In response to Re: documentation structure  (Robert Haas <robertmhaas@gmail.com>)
List pgsql-hackers
On 22.03.24 14:59, Robert Haas wrote:
> And I don't believe that if someone were writing a physical book about
> PostgreSQL from scratch, they'd ever end up with a top-level chapter
> that looks anything like our GiST chapter. All of the index AM
> chapters are quite obviously clones of each other, and they're all
> quite short. Surely you'd make them sections within a chapter, not
> entire chapters.
> 
> I do agree that PL/pgsql is more arguable. I can imagine somebody
> writing a book about PostgreSQL and choosing to make that topic into a
> whole chapter.

Yeah, I think there is probably a range of of things from pretty obvious 
to mostly controversial.



pgsql-hackers by date:

Previous
From: Nathan Bossart
Date:
Subject: Re: add AVX2 support to simd.h
Next
From: Amit Kapila
Date:
Subject: Re: pgsql: Track last_inactive_time in pg_replication_slots.