Re: complex documentation and hard to find the reference

On Mon, Feb 12, 2018 at 7:01 AM, PG Doc comments form <
noreply(at)postgresql(dot)org> 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.
​