public inbox for [email protected]  
help / color / mirror / Atom feed
Typo in Documentation for Version 12 Section 40.3
5+ messages / 4 participants
[nested] [flat]

* Typo in Documentation for Version 12 Section 40.3
@ 2020-01-09 08:05  PG Doc comments form <[email protected]>
  0 siblings, 1 reply; 5+ messages in thread

From: PG Doc comments form @ 2020-01-09 08:05 UTC (permalink / raw)
  To: [email protected]; +Cc: [email protected]

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/10/rules-materializedviews.html
Description:

Hi all,

This is the link to the page which has a typo.
https://www.postgresql.org/docs/10/rules-materializedviews.html. In the line
below the fourth code snippet square, it says:

>>> If people want to be able to quickly graph historical sales data, ...

This sentence doesn't make sense. I think it should be:

--- If people want to be able to quickly grab/obtain/get historical sales
data, ...


Regards,
Yushan


^ permalink  raw  reply  [nested|flat] 5+ messages in thread

* Re: Typo in Documentation for Version 12 Section 40.3
@ 2020-01-09 09:16  Daniel Gustafsson <[email protected]>
  parent: PG Doc comments form <[email protected]>
  0 siblings, 1 reply; 5+ messages in thread

From: Daniel Gustafsson @ 2020-01-09 09:16 UTC (permalink / raw)
  To: [email protected]; [email protected]

> On 9 Jan 2020, at 09:05, PG Doc comments form <[email protected]> wrote:

>>>> If people want to be able to quickly graph historical sales data, ...
> 
> This sentence doesn't make sense. I think it should be:
> 
> --- If people want to be able to quickly grab/obtain/get historical sales
> data, ...


I'm not a native english speaker, but I'm pretty sure that sentence is correct.
"graph" in this context refers to generating a graph of the data, which is made
quite clear in the sentence below the codesnippet:

	"This materialized view might be useful for displaying a graph in the
	dashboard created for salespeople."

cheers ./daniel




^ permalink  raw  reply  [nested|flat] 5+ messages in thread

* Re: Typo in Documentation for Version 12 Section 40.3
@ 2020-01-09 09:34  Octopus ZHANG <[email protected]>
  parent: Daniel Gustafsson <[email protected]>
  0 siblings, 1 reply; 5+ messages in thread

From: Octopus ZHANG @ 2020-01-09 09:34 UTC (permalink / raw)
  To: ; +Cc: [email protected]

I partially agree. But with the context, it doesn't assume we want
`view<->visualize`  the data. It also says:

>> Another use for a materialized view is to allow faster access to data
brought across from a remote system through a foreign data wrapper.

It is talking about 'the view' not the graph.


Yushan


Daniel Gustafsson <[email protected]> 于2020年1月9日周四 下午5:16写道:

> > On 9 Jan 2020, at 09:05, PG Doc comments form <[email protected]>
> wrote:
>
> >>>> If people want to be able to quickly graph historical sales data, ...
> >
> > This sentence doesn't make sense. I think it should be:
> >
> > --- If people want to be able to quickly grab/obtain/get historical sales
> > data, ...
>
>
> I'm not a native english speaker, but I'm pretty sure that sentence is
> correct.
> "graph" in this context refers to generating a graph of the data, which is
> made
> quite clear in the sentence below the codesnippet:
>
>         "This materialized view might be useful for displaying a graph in
> the
>         dashboard created for salespeople."
>
> cheers ./daniel



-- 

--------------------------------------------------------------------------------
Apologize to any possible reply delay for time differences.
对于任何由于时差未能及时回复邮件的情况表示抱歉。


^ permalink  raw  reply  [nested|flat] 5+ messages in thread

* Re: Typo in Documentation for Version 12 Section 40.3
@ 2020-01-09 09:55  Daniel Gustafsson <[email protected]>
  parent: Octopus ZHANG <[email protected]>
  0 siblings, 1 reply; 5+ messages in thread

From: Daniel Gustafsson @ 2020-01-09 09:55 UTC (permalink / raw)
  To: Octopus ZHANG <[email protected]>; +Cc: [email protected]

> On 9 Jan 2020, at 10:34, Octopus ZHANG <[email protected]> wrote:

Please don't top-post on the mailinglists.

> I partially agree. But with the context, it doesn't assume we want `view<->visualize`  the data. It also says:
> 
> >> Another use for a materialized view is to allow faster access to data brought across from a remote system through a foreign data wrapper. 
> 
> It is talking about 'the view' not the graph.

My reading is that it's referring to the usecase for the view, and that is to
use the summarized data in a graph. So I think it's correct.

cheers ./daniel




^ permalink  raw  reply  [nested|flat] 5+ messages in thread

* Re: Typo in Documentation for Version 12 Section 40.3
@ 2020-01-09 13:57  Tom Lane <[email protected]>
  parent: Daniel Gustafsson <[email protected]>
  0 siblings, 0 replies; 5+ messages in thread

From: Tom Lane @ 2020-01-09 13:57 UTC (permalink / raw)
  To: Daniel Gustafsson <[email protected]>; +Cc: Octopus ZHANG <[email protected]>; [email protected]

Daniel Gustafsson <[email protected]> writes:
>> On 9 Jan 2020, at 10:34, Octopus ZHANG <[email protected]> wrote:
>> I partially agree. But with the context, it doesn't assume we want `view<->visualize`  the data. It also says:
>>> Another use for a materialized view is to allow faster access to data brought across from a remote system through a foreign data wrapper. 
>> It is talking about 'the view' not the graph.

> My reading is that it's referring to the usecase for the view, and that is to
> use the summarized data in a graph. So I think it's correct.

The first sentence uses "graph" as a verb, while the next one uses
"graph" as a noun.  Both are correct English, but I can understand that
the inconsistency might confuse non-native speakers.  Not sure if it's
worth changing.

			regards, tom lane






^ permalink  raw  reply  [nested|flat] 5+ messages in thread


end of thread, other threads:[~2020-01-09 13:57 UTC | newest]

Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2020-01-09 08:05 Typo in Documentation for Version 12 Section 40.3 PG Doc comments form <[email protected]>
2020-01-09 09:16 ` Daniel Gustafsson <[email protected]>
2020-01-09 09:34   ` Octopus ZHANG <[email protected]>
2020-01-09 09:55     ` Daniel Gustafsson <[email protected]>
2020-01-09 13:57       ` Tom Lane <[email protected]>

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox