Re: documentation structure

Поиск
Список
Период
Сортировка
От David G. Johnston
Тема Re: documentation structure
Дата
Msg-id CAKFQuwb8tScHpxJJ8CMxgvyOBYgPeS+iF4Fymfnpn=GBbFubAw@mail.gmail.com
обсуждение исходный текст
Ответ на Re: documentation structure  (Robert Haas <robertmhaas@gmail.com>)
Список pgsql-hackers
On Thu, Mar 21, 2024 at 11:30 AM Robert Haas <robertmhaas@gmail.com> wrote:

My second thought is that the stuff from "VII. Internals" that I
categorized as reference material should move into section "VI.
Reference". I think we should also consider moving appendix F,
"Additional Supplied Modules and Extensions," and appendix G,
"Additional Supplied Programs" to the reference section.


For "VI. Reference" I propose the following Chapters:

SQL Commands
PL/pgSQL
Cumulative Statistics Views
System Views
System Catalogs
Client Applications
Server Applications
Modules and Extensions

-- Remove Appendix G (Programs) altogether and just note for the two that are listed that they are in contrib as opposed to core.

-- The PostgreSQL qualifier doesn't seem helpful and once you add the additional chapters its unusual presence stands out even more.

-- PL/pgSQL gets its own reference chapter since we wrote it.  Stuff like Perl and Python have entire books that the user can consult as reference material for those languages.

David J.

В списке pgsql-hackers по дате отправления:

Предыдущее
От: Vik Fearing
Дата:
Сообщение: Re: Catalog domain not-null constraints
Следующее
От: Peter Eisentraut
Дата:
Сообщение: Re: [HACKERS] make async slave to wait for lsn to be replayed