Re: [PATCH] add link to domain data types section from locale documentation
От | Tom Lane |
---|---|
Тема | Re: [PATCH] add link to domain data types section from locale documentation |
Дата | |
Msg-id | 1116321.1627671908@sss.pgh.pa.us обсуждение исходный текст |
Ответ на | Re: [PATCH] add link to domain data types section from locale documentation (Laurenz Albe <laurenz.albe@cybertec.at>) |
Список | pgsql-docs |
Laurenz Albe <laurenz.albe@cybertec.at> writes: > On Fri, 2021-07-23 at 23:07 +0200, Jürgen Purtz wrote: >> Done at the proposed pages - and a few more. > Looks good to me - changed to "ready for committer". Pushed with a bit of editorialization: * I removed the glossary entry for "Domain (Internet)". AFAICS we have not been making entries for non-SQL usages of terms: you won't find anything about physics under "Atomic", nor anything about flatware under "Fork", nor anything about the postal service under "Postmaster". I don't think this is mere laziness; it could be actively confusing to do so, since someone looking up "domain" from elsewhere in the docs might be unsure which definition is meant. Even in the places where the patch provides an exact link, there's no certainty that a display tool will render the page in such a way that it's impossible to misidentify which entry was linked to. * I also added a bit more detail to the glossary entry, so that people wouldn't have to go read the referenced section to come away with a reasonable mental model of what a domain is. * I thought the changes in information_schema.sgml were pretty haphazard. There are 115 references to "domain" in that file by my count, and there seemed little rationale behind the half dozen you'd chosen to link-ify. I cut it down to just linking from the section for the "domains" view, which seemed like someplace that someone would look first if they were unsure what this was about. regards, tom lane
В списке pgsql-docs по дате отправления: