pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feed"data" not "datums"
4+ messages / 4 participants
[nested] [flat]
* "data" not "datums"
@ 2017-08-01 08:22 mahsh.baheti@gmail.com
2017-08-07 20:15 ` Re: "data" not "datums" Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
0 siblings, 1 reply; 4+ messages in thread
From: mahsh.baheti@gmail.com @ 2017-08-01 08:22 UTC (permalink / raw)
To: pgsql-docs
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/9.4/static/datatype-json.html
Description:
In the section
https://www.postgresql.org/docs/9.4/static/datatype-json.html
Sub-section:
8.14.2. Designing JSON documents effectively
Original text:
"but having a predictable structure makes it easier to write queries that
usefully summarize a set of "documents" (datums) in a table."
Suggested text:
"but having a predictable structure makes it easier to write queries that
usefully summarize a set of "documents" (data) in a table."
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: "data" not "datums"
2017-08-01 08:22 "data" not "datums" mahsh.baheti@gmail.com
@ 2017-08-07 20:15 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
2017-08-07 20:28 ` Re: "data" not "datums" Peter Geoghegan <pg@bowt.ie>
2017-08-07 21:14 ` Re: "data" not "datums" David G. Johnston <david.g.johnston@gmail.com>
0 siblings, 2 replies; 4+ messages in thread
From: Peter Eisentraut @ 2017-08-07 20:15 UTC (permalink / raw)
To: mahsh.baheti@gmail.com; pgsql-docs
On 8/1/17 04:22, mahsh.baheti@gmail.com wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.4/static/datatype-json.html
> Description:
>
> In the section
> https://www.postgresql.org/docs/9.4/static/datatype-json.html
>
> Sub-section:
> 8.14.2. Designing JSON documents effectively
>
> Original text:
> "but having a predictable structure makes it easier to write queries that
> usefully summarize a set of "documents" (datums) in a table."
>
> Suggested text:
> "but having a predictable structure makes it easier to write queries that
> usefully summarize a set of "documents" (data) in a table."
"datum" means something specific in PostgreSQL, and several of those are
most usefully "datums". "data" doesn't really convey the same meaning here.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: "data" not "datums"
2017-08-01 08:22 "data" not "datums" mahsh.baheti@gmail.com
2017-08-07 20:15 ` Re: "data" not "datums" Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
@ 2017-08-07 20:28 ` Peter Geoghegan <pg@bowt.ie>
1 sibling, 0 replies; 4+ messages in thread
From: Peter Geoghegan @ 2017-08-07 20:28 UTC (permalink / raw)
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; +Cc: pgsql-docs
On Mon, Aug 7, 2017 at 1:15 PM, Peter Eisentraut
<peter.eisentraut@2ndquadrant.com> wrote:
> "datum" means something specific in PostgreSQL, and several of those are
> most usefully "datums". "data" doesn't really convey the same meaning here.
We're not the first one to use "datums" like this. I think of it as
being like the use of "people" versus the use of "persons".
--
Peter Geoghegan
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: "data" not "datums"
2017-08-01 08:22 "data" not "datums" mahsh.baheti@gmail.com
2017-08-07 20:15 ` Re: "data" not "datums" Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
@ 2017-08-07 21:14 ` David G. Johnston <david.g.johnston@gmail.com>
1 sibling, 0 replies; 4+ messages in thread
From: David G. Johnston @ 2017-08-07 21:14 UTC (permalink / raw)
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; +Cc: pgsql-docs
On Mon, Aug 7, 2017 at 1:15 PM, Peter Eisentraut <
peter.eisentraut@2ndquadrant.com> wrote:
> On 8/1/17 04:22, mahsh.baheti@gmail.com wrote:
> > The following documentation comment has been logged on the website:
> >
> > Page: https://www.postgresql.org/docs/9.4/static/datatype-json.html
> > Description:
> >
> > In the section
> > https://www.postgresql.org/docs/9.4/static/datatype-json.html
> >
> > Sub-section:
> > 8.14.2. Designing JSON documents effectively
> >
> > Original text:
> > "but having a predictable structure makes it easier to write
> queries that
> > usefully summarize a set of "documents" (datums) in a
> table."
> >
> > Suggested text:
> > "but having a predictable structure makes it easier to write
> queries that
> > usefully summarize a set of "documents" (data) in a
> table."
>
> "datum" means something specific in PostgreSQL, and several of those are
> most usefully "datums". "data" doesn't really convey the same meaning
> here.
>
Peter, ​While your point is accurate the fact is that this seems to be the
only place in the user-facing documentation, aside from "hacker targeted"
material, that the word "datum" in the PostgreSQL sense is used. However,
changing it to "data" doesn't do it for me either. Reading the entire
paragraph, including the first introduction of the term "JSON documents",
leads me to think that the best solution here is to remove the
double-quotes surrounding "documents" and remove the parenthetical
entirely. I'm not seeing how it adds or clarifies anything here - the
reader has been told that an alias for "json value" is "document".
Introducing the concept of "datum" here is just going to prompt questions
such as this.
David J.
^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2017-08-07 21:14 UTC | newest]
Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2017-08-01 08:22 "data" not "datums" mahsh.baheti@gmail.com
2017-08-07 20:15 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
2017-08-07 20:28 ` Peter Geoghegan <pg@bowt.ie>
2017-08-07 21:14 ` David G. Johnston <david.g.johnston@gmail.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox