public inbox for [email protected]  

help / color / mirror / Atom feed

From: David G. Johnston <[email protected]>
To: [email protected]
To: [email protected]
Subject: Re: complex documentation and hard to find the reference
Date: Mon, 12 Feb 2018 07:47:31 -0700
Message-ID: <CAKFQuwbeuPmK8bD4ohDar6wQWoW9uScgY9j+zhByQK6mi3pDAw@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

On Mon, Feb 12, 2018 at 7:01 AM, PG Doc comments form <
[email protected]> wrote:

> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.5/static/functions-json.html
> Description:
>
> with the prior experience of mysql or mongoDb or any other. Documentation
> can be understood. But without any experience of those, hard to try the
> JSONB data type.
>
>
​The functions chapter assumes that one has read the earlier "Data Types"
chapter for JSON first.  There are many examples there.

https://www.postgresql.org/docs/10/static/datatype-json.html


> Specify operand places in a select query (give the entire example query).
>
​
​That would be unnecessarily verbose in almost all cases.  Is there a
specific one that is particularly confusing for which a more detailed
example should provided?

The function reference chapter assumes that people know how to write
queries and just need to know which functions are available.  Other
chapters in the documentation cover describing how to do the former.​

​David J.
​

view thread (2+ messages)

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: complex documentation and hard to find the reference
  In-Reply-To: <CAKFQuwbeuPmK8bD4ohDar6wQWoW9uScgY9j+zhByQK6mi3pDAw@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

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