Re: [PATCH] Add section headings to index types doc

Поиск
Список
Период
Сортировка
От Jürgen Purtz
Тема Re: [PATCH] Add section headings to index types doc
Дата
Msg-id dade356d-057a-d488-709b-bdb17713dd3c@purtz.de
обсуждение исходный текст
Ответ на Re: [PATCH] Add section headings to index types doc  ("David G. Johnston" <david.g.johnston@gmail.com>)
Ответы Re: [PATCH] Add section headings to index types doc  (Tom Lane <tgl@sss.pgh.pa.us>)
Список pgsql-hackers
On 23.10.20 18:08, David G. Johnston wrote:
On Fri, Oct 23, 2020 at 3:18 AM Jürgen Purtz <juergen@purtz.de> wrote:
and add a link to the "CREATE INDEX" command from the chapter preamble.
is the link necessary?

I suppose it would make more sense to add it to the previous section - the introduction page.  I do think having a link (or more than one) to CREATE INDEX from the Indexes chapter is reader friendly.  Having links to SQL commands is never truly necessary - the reader knows a SQL command reference exists and the name of the command allows them to find the correct page.

David J.

I'm afraid I haven't grasped everything of your intentions and suggestions of your last two mails.

- equal operator in standalone paragraph: ok, integrated.

- shift "create index ... using HASH" to a different place: You suggest shifting the statement or a link to the previous (sub-)chapter "11.1 Introduction"? But there is already a "create index" example. Please read my suggestion/modification in the first paragraph of the "11.2 Index Types" page.

- "rewording hash": I don't know what is missing here. But I have added a few words about the nature of this index type.

Attached are two patches: a) summary against master and b) standalone of my current changes.

--

J. Purtz

Вложения

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

Предыдущее
От: Noah Misch
Дата:
Сообщение: Re: pgstat_report_activity() and parallel CREATE INDEX (was: Parallel index creation & pg_stat_activity)
Следующее
От: David Rowley
Дата:
Сообщение: Re: Fix typo in src/backend/utils/cache/lsyscache.c