Re: Add A Glossary
Alvaro Herrera <alvherre@2ndquadrant.com>
From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Corey Huinker <corey.huinker@gmail.com>
Cc: Justin Pryzby <pryzby@telsasoft.com>, pgsql-hackers@postgresql.org
Date: 2020-04-02T08:43:28Z
Lists: pgsql-hackers, pgsql-docs
Attachments
- 0001-glossary-v6.patch (text/x-diff) patch v6-0001
On 2020-Apr-01, Corey Huinker wrote: > > I propose we define "planner" and make "optimizer" a <glosssee> entry. > > I have no objection to more entries, or edits to entries, but am concerned > that the process leads to someone having to manually merge several > start-from-scratch patches, with no clear sense of when we'll be done. I > may make sense to appoint an edit-collector. I added "query planner" (please suggest edits) and "query" (using Justin's def) and edited the defs of the ACID terms a little bit (in particular moved the definition of atomic transaction to "atomicity" from "atomic", and made the latter reference the former instead of the other way around). Also removed "Aggregating" as suggested upthread. I moved "master" over to "primary (server)", keeping the ref; we don't use the former much. There's only one "serious" mistake in the defs AFAICS which is that of "global objects". Only roles, tablespace, databases are global objects. Objects that are not in a schema (extensions, etc) are not "global" in that sense. I think all <glossterm> used in definitions should have linkend. I hope to get this committed today, but I'm going to sleep now so if you want to suggest further edits, now's the time. I think the terms proposed by Justin are good to have -- please discuss the defs he proposed -- only "normalized" I'd rather stay away from. Thanks, -- Álvaro Herrera https://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
Commits
-
Glossary: Add term "base backup"
- 606c3845988d 14.0 landed
-
Minor glossary tweaks
- a0b2d583db9f 14.0 landed
- ac25e7b039d5 13.0 landed
-
Adjust some glossary terms
- 91a890bd7fef 13.0 landed
- 816cbb59e300 14.0 landed
-
Fix more typos and grammar problems in the glossary
- eeba6c7e4366 13.0 landed
-
Review of the glossary
- 756abe2bc760 13.0 landed
-
Add a glossary to the documentation
- 347d2b07fcc2 13.0 landed